]> git.pld-linux.org Git - packages/exim.git/blame - exim.conf
- file owners fixed (semi-automatically)
[packages/exim.git] / exim.conf
CommitLineData
6a7ed0b9 1######################################################################
2# Runtime configuration file for Exim #
3######################################################################
4
5
6# This is a default configuration file which will operate correctly in
7# uncomplicated installations. Please see the manual for a complete list
8# of all the runtime configuration options that can be included in a
9# configuration file. There are many more than are mentioned here. The
10# manual is in the file doc/spec.txt in the Exim distribution as a plain
11# ASCII file. Other formats (PostScript, Texinfo, HTML) are available from
12# the Exim ftp sites. The manual is also online via the Exim web sites.
13
14
15# This file is divided into several parts, all but the last of which are
16# terminated by a line containing the word "end". The parts must appear
17# in the correct order, and all must be present (even if some of them are
18# in fact empty). Blank lines, and lines starting with # are ignored.
19
20
21
22######################################################################
23# MAIN CONFIGURATION SETTINGS #
24######################################################################
25
26# Specify your host's canonical name here. This should normally be the fully
27# qualified "official" name of your host. If this option is not set, the
28# uname() function is called to obtain the name.
29
30# primary_hostname =
31
32
33# Specify the domain you want to be added to all unqualified addresses
34# here. An unqualified address is one that does not contain an "@" character
35# followed by a domain. For example, "caesar@rome.ex" is a fully qualified
36# address, but the string "caesar" (i.e. just a login name) is an unqualified
37# email address. Unqualified addresses are accepted only from local callers by
38# default. See the receiver_unqualified_{hosts,nets} options if you want
39# to permit unqualified addresses from remote sources. If this option is
40# not set, the primary_hostname value is used for qualification.
41
42# qualify_domain =
43
44
45# If you want unqualified recipient addresses to be qualified with a different
46# domain to unqualified sender addresses, specify the recipient domain here.
47# If this option is not set, the qualify_domain value is used.
48
49# qualify_recipient =
50
51
52# Specify your local domains as a colon-separated list here. If this option
53# is not set (i.e. not mentioned in the configuration file), the
54# qualify_recipient value is used as the only local domain. If you do not want
55# to do any local deliveries, uncomment the following line, but do not supply
56# any data for it. This sets local_domains to an empty string, which is not
57# the same as not mentioning it at all. An empty string specifies that there
58# are no local domains; not setting it at all causes the default value (the
59# setting of qualify_recipient) to be used.
60
61# local_domains =
62
63
64# If you want to accept mail addressed to your host's literal IP address, for
65# example, mail addressed to "user@[111.111.111.111]", then uncomment the
66# following line, or supply the literal domain(s) as part of "local_domains"
67# above.
68
69# local_domains_include_host_literals
70
71
72# No local deliveries will ever be run under the uids of these users (a colon-
73# separated list). An attempt to do so gets changed so that it runs under the
74# uid of "nobody" instead. This is a paranoic safety catch. Note the default
75# setting means you cannot deliver mail addressed to root as if it were a
76# normal user. This isn't usually a problem, as most sites have an alias for
77# root that redirects such mail to a human administrator.
78
79never_users = root
80
81
9c228cad
AM
82# The use of your host as a mail relay by any host, including the local host
83# calling its own SMTP port, is locked out by default. If you want to permit
84# relaying from the local host, you should set
85#
86host_accept_relay = localhost
87#
88# If you want to permit relaying through your host from certain hosts or IP
89# networks, you need to set the option appropriately, for example
90#
91# host_accept_relay = my.friends.host : 131.111.0.0/16
92#
93# If you are an MX backup or gateway of some kind for some domains, you must
94# set relay_domains to match those domains. This will allow any host to
95# relay through your host to those domains.
96#
97# See the section of the manual entitled "Control of relaying" for more
98# information.
99
100
6a7ed0b9 101# The setting below causes Exim to do a reverse DNS lookup on all incoming
102# IP calls, in order to get the true host name. If you feel this is too
103# expensive, you can specify the networks for which a lookup is done, or
104# remove the setting entirely.
105
9c228cad
AM
106host_lookup = 0.0.0.0/0
107
108
109# By default, Exim expects all envelope addresses to be fully qualified, that
110# is, they must contain both a local part and a domain. If you want to accept
111# unqualified addresses (just a local part) from certain hosts, you can specify
112# these hosts by setting one or both of
113#
114# receiver_unqualified_hosts =
115# sender_unqualified_hosts =
116#
117# to control sender and receiver addresses, respectively. When this is done,
118# unqualified addresses are qualified using the settings of qualify_domain
119# and/or qualify_recipient (see above).
6a7ed0b9 120
121
122# Exim contains support for the Realtime Blocking List (RBL) that is being
123# maintained as part of the DNS. See http://maps.vix.com/rbl/ for background.
9c228cad
AM
124# Uncommenting the first line below will make Exim reject mail from any
125# host whose IP address is blacklisted in the RBL at maps.vix.com. Some
126# others have followed the RBL lead and have produced other lists: DUL is
127# a list of dial-up addresses, and ORBS is a list of open relay systems. The
128# second line below checks all three lists.
6a7ed0b9 129
130# rbl_domains = rbl.maps.vix.com
9c228cad 131# rbl_domains = rbl.maps.vix.com:dul.maps.vix.com:relays.orbs.org
6a7ed0b9 132
133
134# If you want Exim to support the "percent hack" for all your local domains,
135# uncomment the following line. This is the feature by which mail addressed
136# to x%y@z (where z is one of your local domains) is locally rerouted to
137# x@y and sent on. Otherwise x%y is treated as an ordinary local part.
138
139# percent_hack_domains = *
140
9c228cad 141
6a7ed0b9 142# This emulates sendmails "newaliases". Keep in mind that the alias
143# transport does use lsearch by default. remember to change this,
144# if you want to use DBM-Lookups.
145
146bi_command=/usr/bin/newaliases
9c228cad 147
6a7ed0b9 148end
149
150
151
152######################################################################
153# TRANSPORTS CONFIGURATION #
154######################################################################
155# ORDER DOES NOT MATTER #
156# Only one appropriate transport is called for each delivery. #
157######################################################################
158
159# A transport is used only when referenced from a director or a router that
160# successfully handles an address.
161
162
163# This transport is used for delivering messages over SMTP connections.
164
165remote_smtp:
166 driver = smtp
167
168
169# This transport is used for local delivery to user mailboxes. By default
170# it will be run under the uid and gid of the local user, and requires
171# the sticky bit to be set on the /var/mail directory. Some systems use
172# the alternative approach of running mail deliveries under a particular
173# group instead of using the sticky bit. The commented options below show
174# how this can be done.
175
176# Modification by Florian Wallner <wallner@speed-link.de> make use of
9c228cad 177# procmail as director if a user has a .procmailrc to avoid breaking
6a7ed0b9 178# something that worked before.
9c228cad 179
6a7ed0b9 180procmail:
181 driver = pipe
182 command = "/usr/bin/procmail -d ${local_part}"
1d0bb91c 183 return_path_add
184# delivery_date_add
185# envelope_to_add
186 check_string = "From "
187 escape_string = ">From "
188 user = $local_part
189# group = mail
190 group = $local_part
9c228cad 191
6a7ed0b9 192local_delivery:
193 driver = appendfile
1d0bb91c 194# file = /var/mail/${local_part}
195 file = ${home}/Mail/Mailbox
6a7ed0b9 196 delivery_date_add
197 envelope_to_add
198 return_path_add
9c228cad 199 group = mail
6a7ed0b9 200# mode = 0660
201
202
9c228cad
AM
203# This transport is used for handling pipe deliveries generated by alias
204# or .forward files. If the pipe generates any standard output, it is returned
205# to the sender of the message as a delivery error. Set return_fail_output
206# instead of return_output if you want this to happen only when the pipe fails
207# to complete normally. You can set different transports for aliases and
208# forwards if you want to - see the references to address_pipe below.
6a7ed0b9 209
210address_pipe:
211 driver = pipe
212 return_output
213
214
9c228cad
AM
215# This transport is used for handling deliveries directly to files that are
216# generated by aliassing or forwarding.
6a7ed0b9 217
218address_file:
219 driver = appendfile
220 delivery_date_add
221 envelope_to_add
222 return_path_add
223
224
6a7ed0b9 225# This transport is used for handling autoreplies generated by the filtering
9c228cad 226# option of the forwardfile director.
6a7ed0b9 227
228address_reply:
229 driver = autoreply
230
231
232end
233
234
235
236######################################################################
237# DIRECTORS CONFIGURATION #
238# Specifies how local addresses are handled #
239######################################################################
240# ORDER DOES MATTER #
241# A local address is passed to each in turn until it is accepted. #
242######################################################################
243
244# Local addresses are those with a domain that matches some item in the
245# "local_domains" setting above, or those which are passed back from the
246# routers because of a "self=local" setting (not used in this configuration).
247
248
249# This director handles aliasing using a traditional /etc/aliases file.
250# If any of your aliases expand to pipes or files, you will need to set
251# up a user and a group for these deliveries to run under. You can do
252# this by uncommenting the "user" option below (changing the user name
9c228cad
AM
253# as appropriate) and adding a "group" option if necessary. Alternatively, you
254# can specify "user" on the transports that are used. Note that those
255# listed below are the same as are used for .forward files; you might want
256# to set up different ones for pipe and file deliveries from aliases.
6a7ed0b9 257
258# Modification by Florian Wallner <wallner@speed-link.de> use dbm
9c228cad
AM
259# lookups for aliases to speed up and simulate Sendmail behaviour
260
6a7ed0b9 261
9c228cad 262system_aliases:
6a7ed0b9 263 driver = aliasfile
264 file = /var/spool/exim/db/aliases
265 search_type = dbm
9c228cad
AM
266 user = mail
267 file_transport = address_file
268 pipe_transport = address_pipe
6a7ed0b9 269
270#system_aliases:
271# driver = aliasfile
272# file = /etc/aliases
273# search_type = lsearch
274# user = exim
9c228cad
AM
275# file_transport = address_file
276# pipe_transport = address_pipe
6a7ed0b9 277
278
279# This director handles forwarding using traditional .forward files.
280# If you want it also to allow mail filtering when a forward file
281# starts with the string "# Exim filter", uncomment the "filter" option.
282# The check_ancestor option means that if the forward file generates an
283# address that is an ancestor of the current one, the current one gets
284# passed on instead. This covers the case where A is aliased to B and B
9c228cad
AM
285# has a .forward file pointing to A. The three transports specified at the
286# end are those that are used when forwarding generates a direct delivery
287# to a file, or to a pipe, or sets up an auto-reply, respectively.
6a7ed0b9 288
289userforward:
290 driver = forwardfile
291 file = .forward
292 no_verify
293 no_expn
294 check_ancestor
295# filter
9c228cad
AM
296 file_transport = address_file
297 pipe_transport = address_pipe
298 reply_transport = address_reply
299
300
301# This director matches local user mailboxes.
6a7ed0b9 302
303# Modification by Florian Wallner <wallner@speed-link.de> make use of
304# procmail as director if a user has a .procmailrc to avoid breaking
9c228cad
AM
305# something that worked before.
306
6a7ed0b9 307procmail:
308 driver = localuser
309 require_files = ${local_part}:${home}/.procmailrc
9c228cad 310 transport = procmail
6a7ed0b9 311
312localuser:
313 driver = localuser
314 transport = local_delivery
315
316
317end
318
319
320
321######################################################################
322# ROUTERS CONFIGURATION #
323# Specifies how remote addresses are handled #
324######################################################################
325# ORDER DOES MATTER #
326# A remote address is passed to each in turn until it is accepted. #
327######################################################################
328
329# Remote addresses are those with a domain that does not match any item
330# in the "local_domains" setting above.
331
332
333# This router routes to remote hosts over SMTP using a DNS lookup with
334# default options.
335
336lookuphost:
337 driver = lookuphost
338 transport = remote_smtp
339
340
341# This router routes to remote hosts over SMTP by explicit IP address,
342# given as a "domain literal" in the form [nnn.nnn.nnn.nnn]. The RFCs
343# require this facility, which is why it is enabled by default in Exim.
344# If you want to lock it out, set forbid_domain_literals in the main
345# configuration section above.
346
347literal:
348 driver = ipliteral
349 transport = remote_smtp
350
351
352end
353
354
355
356######################################################################
357# RETRY CONFIGURATION #
358######################################################################
359
360# This single retry rule applies to all domains and all errors. It specifies
361# retries every 15 minutes for 2 hours, then increasing retry intervals,
362# starting at 1 hour and increasing each time by a factor of 1.5, up to 16
363# hours, then retries every 8 hours until 4 days have passed since the first
364# failed delivery.
365
366# Domain Error Retries
367# ------ ----- -------
368
369* * F,2h,15m; G,16h,1h,1.5; F,4d,8h
370
371end
372
373
374
375######################################################################
376# REWRITE CONFIGURATION #
377######################################################################
378
379# There are no rewriting specifications in this default configuration file.
380
381# End of Exim configuration file
This page took 0.089348 seconds and 4 git commands to generate.