1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186
|
<!doctype linuxdoc system>
<article>
<title>Basic Postfix Configurations
<author>Cristiano Otto Von Trompczynski
<abstract>
</abstract>
<sect>Local path information
<p>
<descrip>
<tag/Queue directory/
The "Queue directory" option specifies the location of the Postfix queue.
This is also the root directory of Postfix daemons that run chrooted.
See the files in examples/chroot-setup/ for setting up Postfix chroot
environments on different UNIX systems. This option sets the "queue_directory"
postfix variable.
<tag/Command directory/
The "Command directory" option specifies the location of all
postXXX commands. The default value is taken from the "Program directory"
option in Miscellaneous. This option sets the "command_directory"
postfix variable.
<tag/Daemon directory/
The "Daemon directory" option specifies the location of all
Postfix daemon programs (i.e. programs listed in the master.cf
file). The default value is taken from the "Program directory"
option in Miscellaneous. This directory must be owned by root.
This option sets the "daemon_directory" postfix variable.
</descrip>
<sect>Queue and process ownership
<p>
<descrip>
<tag/Mail owner/
The "Mail owner" option specifies the owner of the Postfix queue
and of most "Postfix daemon processes". Specify the name of a
user account THAT DOES NOT SHARE A GROUP WITH OTHER ACCOUNTS AND
THAT OWNS NO OTHER FILES OR PROCESSES ON THE SYSTEM. In particular,
don't specify nobody or daemon. PLEASE USE A DEDICATED USER.
This option sets the "mail_owner" postfix variable.
<tag/Default privileges/
The "Default privileges" option specifies the default rights used
by the local delivery agent for delivery to external file or command.
These rights are used in the absence of a recipient user context.
DO NOT SPECIFY A PRIVILEGED USER OR THE POSTFIX OWNER. This option
sets the "default_privs" postfix variable.
</descrip>
<sect>Internet host and domain names
<p>
<descrip>
<tag/Hostname/
The "Hostname" option specifies the "internet hostname" of this
mail system. The default is to use the fully-qualified domain name
from gethostname(). The "Hostname" option is used as a default value
for many other configuration parameters. This option sets the "myhostname"
postfix variable.
<tag/Domain/
The "Domain" option specifies the local internet domain name.
The default is to use the contents of "Hostname" minus the first
component. The "Domain" option is used as a default value for many
other configuration parameters. This option sets the "mydomain"
postfix variable.
</descrip>
<sect>Sending mail
<p>
<descrip>
<tag/Origin/
The "Origin" option specifies the domain that locally-posted
mail appears to come from. The default is to append "hostname",
which is fine for small sites. If you run a domain with multiple
machines, you should (1) change this to "domain" and (2) set up
a domain-wide alias database that aliases each user to
user@that.users.mailhost. This option sets the "myorigin"
postfix variable.
</descrip>
<sect>Receiving mail
<p>
<descrip>
<tag/Network interface/
The "Network interfaces" option specifies the network interface
addresses that this mail system receives mail on. By default,
the software claims <em/all/ active interfaces on the machine. The
parameter also controls delivery of mail to user@[ip.address]. This
option sets the "inet_interfaces" postfix variable.
<tag/Destination/
The "Destination" option specifies the list of domains that this
machine considers itself the final destination for. That does not
include domains that are hosted on this machine. Those domains are
specified elsewhere (see sample-virtual.cf, and sample-transport.cf).
The default is "myhostname + localhost.$mydomain". On a mail domain
gateway, you should also include "$mydomain". Do not specify the
names of domains that this machine is backup MX host for.
Specify those names via the "Relay domains" option in
'Smtp server program -> Additional UCE controls'.
The local machine is always the final destination for mail addressed
to user@[the.net.work.address] of an interface that the mail system
receives mail on (see the Inet interfaces help).
Specify a list of host or domain names, /file/name or type:table
patterns, separated by commas and/or whitespace. A /file/name
pattern is replaced by its contents; a type:table is matched when
a name matches a lookup key. This option sets the "inet_interfaces"
postfix variable.
DO NOT LIST VIRTUAL DOMAINS HERE. LIST THEM IN THE TABLE->VIRTUAL ITEM
INSTEAD. BE SURE TO READ THE ENTIRE VIRTUAL MANUAL PAGE.
</descrip>
<sect>Rejecting unknown local users
<p>
<descrip>
<tag/Local recipient maps/
The "Local recipient maps" option specifies optional lookup tables
with all users that are local with respect to "$mydestination" and
"$inet_interfaces". If this parameter is defined, then the SMTP
server will reject mail for unknown local users.
The "Local recipient maps" option accepts tables with bare usernames
such as unix:passwd.byname and alias maps.
Beware: if the Postfix SMTP server runs chrooted, you may have to
copy the passwd database into the jail. This is system dependent.
This option sets the "local_recipient_maps" postfix variable.
FOR THIS TO WORK, DO NOT SPECIFY VIRTUAL DOMAINS IN MYDESTINATION.
MYDESTINATION MUST LIST NON-VIRTUAL DOMAINS ONLY.
</descrip>
<sect>Debugging control
<p>
<descrip>
<tag/Debug peer level/
The "Debug peer level" option specifies the increment in verbose
logging level when an SMTP client or server host name or address
matches a pattern in the "Debug peer list" option. This option
sets the "debug_peer_level" postfix variable.
<tag/Debug peer list/
The "Debug peer list" option specifies an optional list of domain
or network patterns, /file/name patterns or type:name tables. When
an SMTP client or server host name or address matches a pattern,
increase the verbose logging level by the amount specified in the
"Debug peer level" option. This option sets the "debug_peer_list"
postfix variable.
<tag/Debugger command/
The "Debugger command" option specifies the external command that
is executed when a Postfix daemon program is run with the -D option.
Use "command .. & sleep 5" so that the debugger can attach before
the process marches on. If you use an X-based debugger, be sure to
set up your XAUTHORITY environment variable before starting Postfix.
This option sets the "debugger_command" postfix variable.
</article>
|