]> git.pld-linux.org Git - packages/exim.git/blame - exim.conf
- updated to rc-scripts 0.2.0
[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}"
9c228cad
AM
183# from_hack
184
6a7ed0b9 185local_delivery:
186 driver = appendfile
187 file = /var/mail/${local_part}
188 delivery_date_add
189 envelope_to_add
190 return_path_add
9c228cad 191 group = mail
6a7ed0b9 192# mode = 0660
193
194
9c228cad
AM
195# This transport is used for handling pipe deliveries generated by alias
196# or .forward files. If the pipe generates any standard output, it is returned
197# to the sender of the message as a delivery error. Set return_fail_output
198# instead of return_output if you want this to happen only when the pipe fails
199# to complete normally. You can set different transports for aliases and
200# forwards if you want to - see the references to address_pipe below.
6a7ed0b9 201
202address_pipe:
203 driver = pipe
204 return_output
205
206
9c228cad
AM
207# This transport is used for handling deliveries directly to files that are
208# generated by aliassing or forwarding.
6a7ed0b9 209
210address_file:
211 driver = appendfile
212 delivery_date_add
213 envelope_to_add
214 return_path_add
215
216
6a7ed0b9 217# This transport is used for handling autoreplies generated by the filtering
9c228cad 218# option of the forwardfile director.
6a7ed0b9 219
220address_reply:
221 driver = autoreply
222
223
224end
225
226
227
228######################################################################
229# DIRECTORS CONFIGURATION #
230# Specifies how local addresses are handled #
231######################################################################
232# ORDER DOES MATTER #
233# A local address is passed to each in turn until it is accepted. #
234######################################################################
235
236# Local addresses are those with a domain that matches some item in the
237# "local_domains" setting above, or those which are passed back from the
238# routers because of a "self=local" setting (not used in this configuration).
239
240
241# This director handles aliasing using a traditional /etc/aliases file.
242# If any of your aliases expand to pipes or files, you will need to set
243# up a user and a group for these deliveries to run under. You can do
244# this by uncommenting the "user" option below (changing the user name
9c228cad
AM
245# as appropriate) and adding a "group" option if necessary. Alternatively, you
246# can specify "user" on the transports that are used. Note that those
247# listed below are the same as are used for .forward files; you might want
248# to set up different ones for pipe and file deliveries from aliases.
6a7ed0b9 249
250# Modification by Florian Wallner <wallner@speed-link.de> use dbm
9c228cad
AM
251# lookups for aliases to speed up and simulate Sendmail behaviour
252
6a7ed0b9 253
9c228cad 254system_aliases:
6a7ed0b9 255 driver = aliasfile
256 file = /var/spool/exim/db/aliases
257 search_type = dbm
9c228cad
AM
258 user = mail
259 file_transport = address_file
260 pipe_transport = address_pipe
6a7ed0b9 261
262#system_aliases:
263# driver = aliasfile
264# file = /etc/aliases
265# search_type = lsearch
266# user = exim
9c228cad
AM
267# file_transport = address_file
268# pipe_transport = address_pipe
6a7ed0b9 269
270
271# This director handles forwarding using traditional .forward files.
272# If you want it also to allow mail filtering when a forward file
273# starts with the string "# Exim filter", uncomment the "filter" option.
274# The check_ancestor option means that if the forward file generates an
275# address that is an ancestor of the current one, the current one gets
276# passed on instead. This covers the case where A is aliased to B and B
9c228cad
AM
277# has a .forward file pointing to A. The three transports specified at the
278# end are those that are used when forwarding generates a direct delivery
279# to a file, or to a pipe, or sets up an auto-reply, respectively.
6a7ed0b9 280
281userforward:
282 driver = forwardfile
283 file = .forward
284 no_verify
285 no_expn
286 check_ancestor
287# filter
9c228cad
AM
288 file_transport = address_file
289 pipe_transport = address_pipe
290 reply_transport = address_reply
291
292
293# This director matches local user mailboxes.
6a7ed0b9 294
295# Modification by Florian Wallner <wallner@speed-link.de> make use of
296# procmail as director if a user has a .procmailrc to avoid breaking
9c228cad
AM
297# something that worked before.
298
6a7ed0b9 299procmail:
300 driver = localuser
301 require_files = ${local_part}:${home}/.procmailrc
9c228cad 302 transport = procmail
6a7ed0b9 303
304localuser:
305 driver = localuser
306 transport = local_delivery
307
308
309end
310
311
312
313######################################################################
314# ROUTERS CONFIGURATION #
315# Specifies how remote addresses are handled #
316######################################################################
317# ORDER DOES MATTER #
318# A remote address is passed to each in turn until it is accepted. #
319######################################################################
320
321# Remote addresses are those with a domain that does not match any item
322# in the "local_domains" setting above.
323
324
325# This router routes to remote hosts over SMTP using a DNS lookup with
326# default options.
327
328lookuphost:
329 driver = lookuphost
330 transport = remote_smtp
331
332
333# This router routes to remote hosts over SMTP by explicit IP address,
334# given as a "domain literal" in the form [nnn.nnn.nnn.nnn]. The RFCs
335# require this facility, which is why it is enabled by default in Exim.
336# If you want to lock it out, set forbid_domain_literals in the main
337# configuration section above.
338
339literal:
340 driver = ipliteral
341 transport = remote_smtp
342
343
344end
345
346
347
348######################################################################
349# RETRY CONFIGURATION #
350######################################################################
351
352# This single retry rule applies to all domains and all errors. It specifies
353# retries every 15 minutes for 2 hours, then increasing retry intervals,
354# starting at 1 hour and increasing each time by a factor of 1.5, up to 16
355# hours, then retries every 8 hours until 4 days have passed since the first
356# failed delivery.
357
358# Domain Error Retries
359# ------ ----- -------
360
361* * F,2h,15m; G,16h,1h,1.5; F,4d,8h
362
363end
364
365
366
367######################################################################
368# REWRITE CONFIGURATION #
369######################################################################
370
371# There are no rewriting specifications in this default configuration file.
372
373# End of Exim configuration file
This page took 0.24359 seconds and 4 git commands to generate.