~ubuntu-branches/ubuntu/maverick/postfix/maverick-security

<h2> Introduction </h2>

 

<p> Postfix has several hundred configuration parameters that are

sensible default values.  In many cases, you need to configure only

two or three parameters before you can start to play with the mail

system. Here's a quick introduction to the syntax:  </p>

<h2> <a name="syntax">Postfix configuration files</a></h2>

 

<p> By default, Postfix configuration files are in /etc/postfix.

must be owned by root.  Giving someone else write permission to

root privileges to that person. </p>

 

of configuration parameters.  Postfix configuration parameters

resemble shell variables, with two important differences: the first

one is that Postfix does not know about quotes like the UNIX shell

 

<blockquote>

<pre>

    parameter = value

</pre>

</blockquote>

 

<blockquote>

<pre>

    other_parameter = $parameter

</pre>

</blockquote>

 

<blockquote>

<pre>

    <a href="postconf.5.html#virtual_alias_maps">virtual_alias_maps</a> = hash:/etc/postfix/virtual

</pre>

</blockquote>

 

execute the following command as root in order to refresh a running

mail system: </p>

 

 

<blockquote>

<pre>

    <a href="postconf.5.html#myorigin">myorigin</a> = $<a href="postconf.5.html#myhostname">myhostname</a> (default: send mail as "user@$<a href="postconf.5.html#myhostname">myhostname</a>")

    <a href="postconf.5.html#myorigin">myorigin</a> = $<a href="postconf.5.html#mydomain">mydomain</a>   (probably desirable: "user@$<a href="postconf.5.html#mydomain">mydomain</a>")

</pre>

 

<blockquote>

<pre>

    <a href="postconf.5.html#mydestination">mydestination</a> = $<a href="postconf.5.html#myhostname">myhostname</a> localhost.$<a href="postconf.5.html#mydomain">mydomain</a> localhost

</pre>

</blockquote>

 

<blockquote>

<pre>

    <a href="postconf.5.html#mydestination">mydestination</a> = $<a href="postconf.5.html#myhostname">myhostname</a> localhost.$<a href="postconf.5.html#mydomain">mydomain</a> localhost $<a href="postconf.5.html#mydomain">mydomain</a>

</pre>

</blockquote>

 

<blockquote>

<pre>

    <a href="postconf.5.html#mydestination">mydestination</a> = $<a href="postconf.5.html#myhostname">myhostname</a> localhost.$<a href="postconf.5.html#mydomain">mydomain</a> localhost 

        www.$<a href="postconf.5.html#mydomain">mydomain</a> ftp.$<a href="postconf.5.html#mydomain">mydomain</a>

</pre>

 

<blockquote>

<pre>

    <a href="postconf.5.html#mynetworks_style">mynetworks_style</a> = subnet  (default: authorize subnetworks)

    <a href="postconf.5.html#mynetworks_style">mynetworks_style</a> = host    (safe: authorize local machine only)

    <a href="postconf.5.html#mynetworks">mynetworks</a> = 127.0.0.0/8   (safe: authorize local machine only)

</pre>

</blockquote>

 

you can let Postfix do the work for you. The default is to let

Postfix do the work. The result depends on the <a href="postconf.5.html#mynetworks_style">mynetworks_style</a>

parameter value.

 

<blockquote>

<pre>

    <a href="postconf.5.html#mynetworks">mynetworks</a> = 168.100.189.0/28, 127.0.0.0/8

</pre>

</blockquote>

 

<p> You can also specify the absolute pathname of a pattern file instead

 

<h2> <a name="relay_to"> What destinations to relay mail to </a> </h2>

 

 

<blockquote>

<pre>

    <a href="postconf.5.html#relay_domains">relay_domains</a> = $<a href="postconf.5.html#mydestination">mydestination</a> (default)

    <a href="postconf.5.html#relay_domains">relay_domains</a> =           (safe: never forward mail from strangers)

    <a href="postconf.5.html#relay_domains">relay_domains</a> = $<a href="postconf.5.html#mydomain">mydomain</a> (forward mail to my domain and subdomains)

office hours, it may be behind a firewall, or it may be connected

via a provider who does not allow direct mail to the Internet.  In

those cases you need to configure Postfix to deliver mail indirectly

 

<p> Examples (specify only one of the following): </p>

 

<blockquote>

<pre>

    <a href="postconf.5.html#relayhost">relayhost</a> =                   (default: direct delivery to Internet)

    <a href="postconf.5.html#relayhost">relayhost</a> = $<a href="postconf.5.html#mydomain">mydomain</a>         (deliver via local mailhub)

    <a href="postconf.5.html#relayhost">relayhost</a> = [mail.$<a href="postconf.5.html#mydomain">mydomain</a>]  (deliver via local mailhub)

 

<blockquote>

<pre>

    <a href="postconf.5.html#notify_classes">notify_classes</a> = resource, software

</pre>

</blockquote>

 

<blockquote>

<pre>

    <a href="postconf.5.html#proxy_interfaces">proxy_interfaces</a> = 1.2.3.4 (the proxy/NAT external network address)

</pre>

</blockquote>

<h2> <a name="chroot_setup"> Running Postfix daemon processes

chrooted </a> </h2>

 

file) to run in a chroot jail.  The processes run at a fixed low

privilege and with file system access limited to the Postfix queue

directories (/var/spool/postfix).  This provides a significant

porcupine.org mail server runs all daemons chrooted that can be

chrooted.  </p>

 

daemon runs chrooted. In order to enable chroot operation, edit

file.  When you're finished, execute "postfix reload" to make the

change effective. </p>

 

specify the fully-qualified domain name that the mail system should

use. </p>

 

will use its value to generate a fully-qualified default value      

for the <a href="postconf.5.html#myhostname">myhostname</a> parameter. </p>

 

 

<blockquote>

<pre>

    <a href="postconf.5.html#myhostname">myhostname</a> = host.local.domain (machine name is not FQDN)

    <a href="postconf.5.html#myhostname">myhostname</a> = host.virtual.domain (virtual interface)

    <a href="postconf.5.html#myhostname">myhostname</a> = virtual.domain (virtual interface)

by stripping off the first part (unless the result would be a

top-level domain). </p>

 

will use its value to generate a fully-qualified default value

for the <a href="postconf.5.html#myhostname">myhostname</a> parameter. </p>

 

 

<blockquote>

<pre>

    <a href="postconf.5.html#mydomain">mydomain</a> = local.domain

    <a href="postconf.5.html#mydomain">mydomain</a> = virtual.domain (virtual interface)

</pre> 

as if it is addressed to a domain listed in  $<a href="postconf.5.html#mydestination">mydestination</a>.</p>

 

<p> You can override the <a href="postconf.5.html#inet_interfaces">inet_interfaces</a> setting in the Postfix

 

<p> The default is to listen on all active interfaces.  If you run

mailers on virtual interfaces, you will have to specify what

 

<blockquote>

<pre>

    <a href="postconf.5.html#inet_interfaces">inet_interfaces</a> = all

</pre>

</blockquote>

 

<blockquote>

<pre>

    <a href="postconf.5.html#inet_interfaces">inet_interfaces</a> = virtual.host.tld         (virtual Postfix)

    <a href="postconf.5.html#inet_interfaces">inet_interfaces</a> = $<a href="postconf.5.html#myhostname">myhostname</a> localhost... (non-virtual Postfix)

</pre>