File: postfix_basic.sgml

package info (click to toggle)
linuxconf 1.26r4-2
  • links: PTS
  • area: main
  • in suites: woody
  • size: 56,432 kB
  • ctags: 27,217
  • sloc: cpp: 158,803; perl: 7,484; sh: 4,134; java: 3,105; ansic: 2,492; makefile: 2,216; python: 109
file content (186 lines) | stat: -rw-r--r-- 6,873 bytes parent folder | download
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>