Commit | Line | Data |
---|---|---|
9ecb03f3 | 1 | # $Cambridge: exim/src/src/configure.default,v 1.10 2006/07/27 10:36:34 ph10 Exp $ |
059ec3d9 PH |
2 | |
3 | ###################################################################### | |
4 | # Runtime configuration file for Exim # | |
5 | ###################################################################### | |
6 | ||
7 | ||
8 | # This is a default configuration file which will operate correctly in | |
9 | # uncomplicated installations. Please see the manual for a complete list | |
10 | # of all the runtime configuration options that can be included in a | |
11 | # configuration file. There are many more than are mentioned here. The | |
12 | # manual is in the file doc/spec.txt in the Exim distribution as a plain | |
13 | # ASCII file. Other formats (PostScript, Texinfo, HTML, PDF) are available | |
14 | # from the Exim ftp sites. The manual is also online at the Exim web sites. | |
15 | ||
16 | ||
17 | # This file is divided into several parts, all but the first of which are | |
18 | # headed by a line starting with the word "begin". Only those parts that | |
19 | # are required need to be present. Blank lines, and lines starting with # | |
20 | # are ignored. | |
21 | ||
22 | ||
23 | ########### IMPORTANT ########## IMPORTANT ########### IMPORTANT ########### | |
24 | # # | |
25 | # Whenever you change Exim's configuration file, you *must* remember to # | |
26 | # HUP the Exim daemon, because it will not pick up the new configuration # | |
27 | # until you do. However, any other Exim processes that are started, for # | |
28 | # example, a process started by an MUA in order to send a message, will # | |
29 | # see the new configuration as soon as it is in place. # | |
30 | # # | |
31 | # You do not need to HUP the daemon for changes in auxiliary files that # | |
32 | # are referenced from this file. They are read every time they are used. # | |
33 | # # | |
34 | # It is usually a good idea to test a new configuration for syntactic # | |
35 | # correctness before installing it (for example, by running the command # | |
36 | # "exim -C /config/file.new -bV"). # | |
37 | # # | |
38 | ########### IMPORTANT ########## IMPORTANT ########### IMPORTANT ########### | |
39 | ||
40 | ||
41 | ||
42 | ###################################################################### | |
43 | # MAIN CONFIGURATION SETTINGS # | |
44 | ###################################################################### | |
45 | ||
46 | # Specify your host's canonical name here. This should normally be the fully | |
47 | # qualified "official" name of your host. If this option is not set, the | |
48 | # uname() function is called to obtain the name. In many cases this does | |
49 | # the right thing and you need not set anything explicitly. | |
50 | ||
51 | # primary_hostname = | |
52 | ||
53 | ||
54 | # The next three settings create two lists of domains and one list of hosts. | |
55 | # These lists are referred to later in this configuration using the syntax | |
56 | # +local_domains, +relay_to_domains, and +relay_from_hosts, respectively. They | |
57 | # are all colon-separated lists: | |
58 | ||
59 | domainlist local_domains = @ | |
60 | domainlist relay_to_domains = | |
61 | hostlist relay_from_hosts = 127.0.0.1 | |
62 | ||
63 | # Most straightforward access control requirements can be obtained by | |
53394084 PH |
64 | # appropriate settings of the above options. In more complicated situations, |
65 | # you may need to modify the Access Control List (ACL) which appears later in | |
66 | # this file. | |
059ec3d9 PH |
67 | |
68 | # The first setting specifies your local domains, for example: | |
69 | # | |
70 | # domainlist local_domains = my.first.domain : my.second.domain | |
71 | # | |
72 | # You can use "@" to mean "the name of the local host", as in the default | |
73 | # setting above. This is the name that is specified by primary_hostname, | |
74 | # as specified above (or defaulted). If you do not want to do any local | |
75 | # deliveries, remove the "@" from the setting above. If you want to accept mail | |
76 | # addressed to your host's literal IP address, for example, mail addressed to | |
77 | # "user@[192.168.23.44]", you can add "@[]" as an item in the local domains | |
78 | # list. You also need to uncomment "allow_domain_literals" below. This is not | |
79 | # recommended for today's Internet. | |
80 | ||
81 | # The second setting specifies domains for which your host is an incoming relay. | |
82 | # If you are not doing any relaying, you should leave the list empty. However, | |
83 | # if your host is an MX backup or gateway of some kind for some domains, you | |
84 | # must set relay_to_domains to match those domains. For example: | |
85 | # | |
86 | # domainlist relay_to_domains = *.myco.com : my.friend.org | |
87 | # | |
88 | # This will allow any host to relay through your host to those domains. | |
89 | # See the section of the manual entitled "Control of relaying" for more | |
90 | # information. | |
91 | ||
92 | # The third setting specifies hosts that can use your host as an outgoing relay | |
93 | # to any other host on the Internet. Such a setting commonly refers to a | |
94 | # complete local network as well as the localhost. For example: | |
95 | # | |
96 | # hostlist relay_from_hosts = 127.0.0.1 : 192.168.0.0/16 | |
97 | # | |
98 | # The "/16" is a bit mask (CIDR notation), not a number of hosts. Note that you | |
99 | # have to include 127.0.0.1 if you want to allow processes on your host to send | |
100 | # SMTP mail by using the loopback address. A number of MUAs use this method of | |
101 | # sending mail. | |
102 | ||
059ec3d9 PH |
103 | # All three of these lists may contain many different kinds of item, including |
104 | # wildcarded names, regular expressions, and file lookups. See the reference | |
74e0617f PH |
105 | # manual for details. The lists above are used in the access control lists for |
106 | # checking incoming messages. The names of these ACLs are defined here: | |
059ec3d9 PH |
107 | |
108 | acl_smtp_rcpt = acl_check_rcpt | |
74e0617f PH |
109 | acl_smtp_data = acl_check_data |
110 | ||
111 | # You should not change those settings until you understand how ACLs work. | |
112 | ||
113 | ||
114 | # If you are running a version of Exim that was compiled with the content- | |
115 | # scanning extension, you can cause incoming messages to be automatically | |
116 | # scanned for viruses. You have to modify the configuration in two places to | |
117 | # set this up. The first of them is here, where you define the interface to | |
118 | # your scanner. This example is typical for ClamAV; see the manual for details | |
119 | # of what to set for other virus scanners. The second modification is in the | |
120 | # acl_check_data access control list (see below). | |
059ec3d9 | 121 | |
74e0617f PH |
122 | # av_scanner = clamd:/tmp/clamd |
123 | ||
124 | ||
125 | # For spam scanning, there is a similar option that defines the interface to | |
126 | # SpamAssassin. You do not need to set this if you are using the default, which | |
127 | # is shown in this commented example. As for virus scanning, you must also | |
128 | # modify the acl_check_data access control list to enable spam scanning. | |
129 | ||
130 | # spamd_address = 127.0.0.1 783 | |
059ec3d9 PH |
131 | |
132 | ||
6083aca0 TF |
133 | # If Exim is compiled with support for TLS, you may want to enable the |
134 | # following options so that Exim allows clients to make encrypted | |
135 | # connections. In the authenticators section below, there are template | |
136 | # configurations for plaintext username/password authentication. This kind | |
137 | # of authentication is only safe when used within a TLS connection, so the | |
138 | # authenticators will only work if the following TLS settings are turned on | |
139 | # as well. | |
140 | ||
141 | # Allow any client to use TLS. | |
142 | ||
143 | # tls_advertise_hosts = * | |
144 | ||
145 | # Specify the location of the Exim server's TLS certificate and private key. | |
146 | # The private key must not be encrypted (password protected). You can put | |
147 | # the certificate and private key in the same file, in which case you only | |
148 | # need the first setting, or in separate files, in which case you need both | |
149 | # options. | |
150 | ||
151 | # tls_certificate = /etc/ssl/exim.crt | |
152 | # tls_privatekey = /etc/ssl/exim.pem | |
153 | ||
154 | # In order to support roaming users who wish to send email from anywhere, | |
155 | # you may want to make Exim listen on other ports as well as port 25, in | |
156 | # case these users need to send email from a network that blocks port 25. | |
157 | # The standard port for this purpose is port 587, the "message submission" | |
158 | # port. See RFC 4409 for details. Microsoft MUAs cannot be configured to | |
159 | # talk the message submission protocol correctly, so if you need to support | |
160 | # them you should also allow TLS-on-connect on the traditional but | |
161 | # non-standard port 465. | |
162 | ||
163 | # daemon_smtp_ports = 25 : 465 : 587 | |
164 | # tls_on_connect_ports = 465 | |
165 | ||
166 | ||
059ec3d9 PH |
167 | # Specify the domain you want to be added to all unqualified addresses |
168 | # here. An unqualified address is one that does not contain an "@" character | |
169 | # followed by a domain. For example, "caesar@rome.example" is a fully qualified | |
170 | # address, but the string "caesar" (i.e. just a login name) is an unqualified | |
171 | # email address. Unqualified addresses are accepted only from local callers by | |
172 | # default. See the recipient_unqualified_hosts option if you want to permit | |
173 | # unqualified addresses from remote sources. If this option is not set, the | |
174 | # primary_hostname value is used for qualification. | |
175 | ||
176 | # qualify_domain = | |
177 | ||
178 | ||
179 | # If you want unqualified recipient addresses to be qualified with a different | |
180 | # domain to unqualified sender addresses, specify the recipient domain here. | |
181 | # If this option is not set, the qualify_domain value is used. | |
182 | ||
183 | # qualify_recipient = | |
184 | ||
185 | ||
186 | # The following line must be uncommented if you want Exim to recognize | |
187 | # addresses of the form "user@[10.11.12.13]" that is, with a "domain literal" | |
188 | # (an IP address) instead of a named domain. The RFCs still require this form, | |
189 | # but it makes little sense to permit mail to be sent to specific hosts by | |
190 | # their IP address in the modern Internet. This ancient format has been used | |
191 | # by those seeking to abuse hosts by using them for unwanted relaying. If you | |
192 | # really do want to support domain literals, uncomment the following line, and | |
193 | # see also the "domain_literal" router below. | |
194 | ||
195 | # allow_domain_literals | |
196 | ||
197 | ||
198 | # No deliveries will ever be run under the uids of these users (a colon- | |
199 | # separated list). An attempt to do so causes a panic error to be logged, and | |
200 | # the delivery to be deferred. This is a paranoic safety catch. There is an | |
201 | # even stronger safety catch in the form of the FIXED_NEVER_USERS setting | |
202 | # in the configuration for building Exim. The list of users that it specifies | |
203 | # is built into the binary, and cannot be changed. The option below just adds | |
204 | # additional users to the list. The default for FIXED_NEVER_USERS is "root", | |
205 | # but just to be absolutely sure, the default here is also "root". | |
206 | ||
207 | # Note that the default setting means you cannot deliver mail addressed to root | |
208 | # as if it were a normal user. This isn't usually a problem, as most sites have | |
209 | # an alias for root that redirects such mail to a human administrator. | |
210 | ||
211 | never_users = root | |
212 | ||
213 | ||
214 | # The setting below causes Exim to do a reverse DNS lookup on all incoming | |
215 | # IP calls, in order to get the true host name. If you feel this is too | |
216 | # expensive, you can specify the networks for which a lookup is done, or | |
217 | # remove the setting entirely. | |
218 | ||
219 | host_lookup = * | |
220 | ||
221 | ||
222 | # The settings below, which are actually the same as the defaults in the | |
223 | # code, cause Exim to make RFC 1413 (ident) callbacks for all incoming SMTP | |
224 | # calls. You can limit the hosts to which these calls are made, and/or change | |
225 | # the timeout that is used. If you set the timeout to zero, all RFC 1413 calls | |
226 | # are disabled. RFC 1413 calls are cheap and can provide useful information | |
227 | # for tracing problem messages, but some hosts and firewalls have problems | |
228 | # with them. This can result in a timeout instead of an immediate refused | |
8def5aaf PH |
229 | # connection, leading to delays on starting up SMTP sessions. (The default was |
230 | # reduced from 30s to 5s for release 4.61.) | |
059ec3d9 PH |
231 | |
232 | rfc1413_hosts = * | |
8def5aaf | 233 | rfc1413_query_timeout = 5s |
059ec3d9 PH |
234 | |
235 | ||
236 | # By default, Exim expects all envelope addresses to be fully qualified, that | |
237 | # is, they must contain both a local part and a domain. If you want to accept | |
238 | # unqualified addresses (just a local part) from certain hosts, you can specify | |
239 | # these hosts by setting one or both of | |
240 | # | |
241 | # sender_unqualified_hosts = | |
242 | # recipient_unqualified_hosts = | |
243 | # | |
244 | # to control sender and recipient addresses, respectively. When this is done, | |
245 | # unqualified addresses are qualified using the settings of qualify_domain | |
246 | # and/or qualify_recipient (see above). | |
247 | ||
248 | ||
249 | # If you want Exim to support the "percent hack" for certain domains, | |
250 | # uncomment the following line and provide a list of domains. The "percent | |
251 | # hack" is the feature by which mail addressed to x%y@z (where z is one of | |
252 | # the domains listed) is locally rerouted to x@y and sent on. If z is not one | |
253 | # of the "percent hack" domains, x%y is treated as an ordinary local part. This | |
254 | # hack is rarely needed nowadays; you should not enable it unless you are sure | |
255 | # that you really need it. | |
256 | # | |
257 | # percent_hack_domains = | |
258 | # | |
259 | # As well as setting this option you will also need to remove the test | |
260 | # for local parts containing % in the ACL definition below. | |
261 | ||
262 | ||
263 | # When Exim can neither deliver a message nor return it to sender, it "freezes" | |
264 | # the delivery error message (aka "bounce message"). There are also other | |
265 | # circumstances in which messages get frozen. They will stay on the queue for | |
266 | # ever unless one of the following options is set. | |
267 | ||
268 | # This option unfreezes frozen bounce messages after two days, tries | |
269 | # once more to deliver them, and ignores any delivery failures. | |
270 | ||
271 | ignore_bounce_errors_after = 2d | |
272 | ||
273 | # This option cancels (removes) frozen messages that are older than a week. | |
274 | ||
275 | timeout_frozen_after = 7d | |
276 | ||
277 | ||
278 | ||
279 | ###################################################################### | |
280 | # ACL CONFIGURATION # | |
281 | # Specifies access control lists for incoming SMTP mail # | |
282 | ###################################################################### | |
283 | ||
284 | begin acl | |
285 | ||
286 | # This access control list is used for every RCPT command in an incoming | |
287 | # SMTP message. The tests are run in order until the address is either | |
288 | # accepted or denied. | |
289 | ||
290 | acl_check_rcpt: | |
291 | ||
292 | # Accept if the source is local SMTP (i.e. not over TCP/IP). We do this by | |
293 | # testing for an empty sending host field. | |
294 | ||
295 | accept hosts = : | |
296 | ||
297 | ############################################################################# | |
298 | # The following section of the ACL is concerned with local parts that contain | |
299 | # @ or % or ! or / or | or dots in unusual places. | |
300 | # | |
301 | # The characters other than dots are rarely found in genuine local parts, but | |
302 | # are often tried by people looking to circumvent relaying restrictions. | |
303 | # Therefore, although they are valid in local parts, these rules lock them | |
304 | # out, as a precaution. | |
305 | # | |
306 | # Empty components (two dots in a row) are not valid in RFC 2822, but Exim | |
307 | # allows them because they have been encountered. (Consider local parts | |
308 | # constructed as "firstinitial.secondinitial.familyname" when applied to | |
309 | # someone like me, who has no second initial.) However, a local part starting | |
310 | # with a dot or containing /../ can cause trouble if it is used as part of a | |
311 | # file name (e.g. for a mailing list). This is also true for local parts that | |
312 | # contain slashes. A pipe symbol can also be troublesome if the local part is | |
313 | # incorporated unthinkingly into a shell command line. | |
314 | # | |
315 | # Two different rules are used. The first one is stricter, and is applied to | |
316 | # messages that are addressed to one of the local domains handled by this | |
53394084 PH |
317 | # host. The line "domains = +local_domains" restricts it to domains that are |
318 | # defined by the "domainlist local_domains" setting above. The rule blocks | |
319 | # local parts that begin with a dot or contain @ % ! / or |. If you have | |
320 | # local accounts that include these characters, you will have to modify this | |
321 | # rule. | |
059ec3d9 PH |
322 | |
323 | deny message = Restricted characters in address | |
324 | domains = +local_domains | |
325 | local_parts = ^[.] : ^.*[@%!/|] | |
326 | ||
53394084 PH |
327 | # The second rule applies to all other domains, and is less strict. The line |
328 | # "domains = !+local_domains" restricts it to domains that are NOT defined by | |
329 | # the "domainlist local_domains" setting above. The exclamation mark is a | |
330 | # negating operator. This rule allows your own users to send outgoing | |
331 | # messages to sites that use slashes and vertical bars in their local parts. | |
332 | # It blocks local parts that begin with a dot, slash, or vertical bar, but | |
333 | # allows these characters within the local part. However, the sequence /../ | |
334 | # is barred. The use of @ % and ! is blocked, as before. The motivation here | |
335 | # is to prevent your users (or your users' viruses) from mounting certain | |
336 | # kinds of attack on remote sites. | |
059ec3d9 PH |
337 | |
338 | deny message = Restricted characters in address | |
339 | domains = !+local_domains | |
340 | local_parts = ^[./|] : ^.*[@%!] : ^.*/\\.\\./ | |
341 | ############################################################################# | |
342 | ||
343 | # Accept mail to postmaster in any local domain, regardless of the source, | |
344 | # and without verifying the sender. | |
345 | ||
346 | accept local_parts = postmaster | |
347 | domains = +local_domains | |
348 | ||
349 | # Deny unless the sender address can be verified. | |
350 | ||
351 | require verify = sender | |
352 | ||
5de37277 | 353 | # Accept if the message comes from one of the hosts for which we are an |
cc38ddbf PH |
354 | # outgoing relay. It is assumed that such hosts are most likely to be MUAs, |
355 | # so we set control=submission to make Exim treat the message as a | |
356 | # submission. It will fix up various errors in the message, for example, the | |
357 | # lack of a Date: header line. If you are actually relaying out out from | |
358 | # MTAs, you may want to disable this. If you are handling both relaying from | |
359 | # MTAs and submissions from MUAs you should probably split them into two | |
360 | # lists, and handle them differently. | |
361 | ||
362 | # Recipient verification is omitted here, because in many cases the clients | |
363 | # are dumb MUAs that don't cope well with SMTP error responses. If you are | |
364 | # actually relaying out from MTAs, you should probably add recipient | |
365 | # verification here. | |
366 | ||
367 | # Note that, by putting this test before any DNS black list checks, you will | |
368 | # always accept from these hosts, even if they end up on a black list. The | |
369 | # assumption is that they are your friends, and if they get onto a black | |
370 | # list, it is a mistake. | |
5de37277 PH |
371 | |
372 | accept hosts = +relay_from_hosts | |
cc38ddbf | 373 | control = submission |
5de37277 PH |
374 | |
375 | # Accept if the message arrived over an authenticated connection, from | |
376 | # any host. Again, these messages are usually from MUAs, so recipient | |
cc38ddbf PH |
377 | # verification is omitted, and submission mode is set. And again, we do this |
378 | # check before any black list tests. | |
5de37277 PH |
379 | |
380 | accept authenticated = * | |
cc38ddbf | 381 | control = submission |
5de37277 | 382 | |
9ecb03f3 PH |
383 | # Insist that any other recipient address that we accept is either in one of |
384 | # our local domains, or is in a domain for which we explicitly allow | |
385 | # relaying. Any other domain is rejected as being unacceptable for relaying. | |
386 | ||
387 | require message = relay not permitted | |
388 | domains = +local_domains : +relay_domains | |
389 | ||
390 | # We also require all accepted addresses to be verifiable. This check will | |
391 | # do local part verification for local domains, but only check the domain | |
392 | # for remote domains. The only way to check local parts for the remote | |
393 | # relay domains is to use a callout (add /callout), but please read the | |
394 | # documentation about callouts before doing this. | |
395 | ||
396 | require verify = recipient | |
397 | ||
059ec3d9 | 398 | ############################################################################# |
5de37277 PH |
399 | # There are no default checks on DNS black lists because the domains that |
400 | # contain these lists are changing all the time. However, here are two | |
401 | # examples of how you can get Exim to perform a DNS black list lookup at this | |
402 | # point. The first one denies, whereas the second just warns. | |
059ec3d9 PH |
403 | # |
404 | # deny message = rejected because $sender_host_address is in a black list at $dnslist_domain\n$dnslist_text | |
405 | # dnslists = black.list.example | |
406 | # | |
42119b09 PH |
407 | # warn dnslists = black.list.example |
408 | # add_header = X-Warning: $sender_host_address is in a black list at $dnslist_domain | |
059ec3d9 | 409 | # log_message = found in $dnslist_domain |
059ec3d9 PH |
410 | ############################################################################# |
411 | ||
a4e3111f PH |
412 | ############################################################################# |
413 | # This check is commented out because it is recognized that not every | |
414 | # sysadmin will want to do it. If you enable it, the check performs | |
415 | # Client SMTP Authorization (csa) checks on the sending host. These checks | |
416 | # do DNS lookups for SRV records. The CSA proposal is currently (May 2005) | |
417 | # an Internet draft. You can, of course, add additional conditions to this | |
418 | # ACL statement to restrict the CSA checks to certain hosts only. | |
419 | # | |
420 | # require verify = csa | |
421 | ############################################################################# | |
422 | ||
9ecb03f3 PH |
423 | # At this point, the address has passed all the checks that have been |
424 | # configured, so we accept it unconditionally. | |
059ec3d9 | 425 | |
9ecb03f3 | 426 | accept |
059ec3d9 PH |
427 | |
428 | ||
74e0617f PH |
429 | # This ACL is used after the contents of a message have been received. This |
430 | # is the ACL in which you can test a message's headers or body, and in | |
431 | # particular, this is where you can invoke external virus or spam scanners. | |
432 | # Some suggested ways of configuring these tests are shown below, commented | |
433 | # out. Without any tests, this ACL accepts all messages. If you want to use | |
434 | # such tests, you must ensure that Exim is compiled with the content-scanning | |
435 | # extension (WITH_CONTENT_SCAN=yes in Local/Makefile). | |
436 | ||
437 | acl_check_data: | |
438 | ||
439 | # Deny if the message contains a virus. Before enabling this check, you | |
440 | # must install a virus scanner and set the av_scanner option above. | |
441 | # | |
42119b09 PH |
442 | # deny malware = * |
443 | # message = This message contains a virus ($malware_name). | |
74e0617f PH |
444 | |
445 | # Add headers to a message if it is judged to be spam. Before enabling this, | |
446 | # you must install SpamAssassin. You may also need to set the spamd_address | |
447 | # option above. | |
448 | # | |
42119b09 PH |
449 | # warn spam = nobody |
450 | # add_header = X-Spam_score: $spam_score\n\ | |
451 | # X-Spam_score_int: $spam_score_int\n\ | |
452 | # X-Spam_bar: $spam_bar\n\ | |
453 | # X-Spam_report: $spam_report | |
74e0617f PH |
454 | |
455 | # Accept the message. | |
456 | ||
457 | accept | |
458 | ||
459 | ||
059ec3d9 PH |
460 | |
461 | ###################################################################### | |
462 | # ROUTERS CONFIGURATION # | |
463 | # Specifies how addresses are handled # | |
464 | ###################################################################### | |
465 | # THE ORDER IN WHICH THE ROUTERS ARE DEFINED IS IMPORTANT! # | |
466 | # An address is passed to each router in turn until it is accepted. # | |
467 | ###################################################################### | |
468 | ||
469 | begin routers | |
470 | ||
471 | # This router routes to remote hosts over SMTP by explicit IP address, | |
472 | # when an email address is given in "domain literal" form, for example, | |
473 | # <user@[192.168.35.64]>. The RFCs require this facility. However, it is | |
474 | # little-known these days, and has been exploited by evil people seeking | |
475 | # to abuse SMTP relays. Consequently it is commented out in the default | |
476 | # configuration. If you uncomment this router, you also need to uncomment | |
477 | # allow_domain_literals above, so that Exim can recognize the syntax of | |
478 | # domain literal addresses. | |
479 | ||
480 | # domain_literal: | |
481 | # driver = ipliteral | |
482 | # domains = ! +local_domains | |
483 | # transport = remote_smtp | |
484 | ||
485 | ||
486 | # This router routes addresses that are not in local domains by doing a DNS | |
53394084 PH |
487 | # lookup on the domain name. The exclamation mark that appears in "domains = ! |
488 | # +local_domains" is a negating operator, that is, it can be read as "not". The | |
489 | # recipient's domain must not be one of those defined by "domainlist | |
490 | # local_domains" above for this router to be used. | |
491 | # | |
492 | # If the router is used, any domain that resolves to 0.0.0.0 or to a loopback | |
493 | # interface address (127.0.0.0/8) is treated as if it had no DNS entry. Note | |
494 | # that 0.0.0.0 is the same as 0.0.0.0/32, which is commonly treated as the | |
495 | # local host inside the network stack. It is not 0.0.0.0/0, the default route. | |
496 | # If the DNS lookup fails, no further routers are tried because of the no_more | |
497 | # setting, and consequently the address is unrouteable. | |
059ec3d9 PH |
498 | |
499 | dnslookup: | |
500 | driver = dnslookup | |
501 | domains = ! +local_domains | |
502 | transport = remote_smtp | |
503 | ignore_target_hosts = 0.0.0.0 : 127.0.0.0/8 | |
504 | no_more | |
505 | ||
506 | ||
53394084 PH |
507 | # The remaining routers handle addresses in the local domain(s), that is those |
508 | # domains that are defined by "domainlist local_domains" above. | |
059ec3d9 PH |
509 | |
510 | ||
511 | # This router handles aliasing using a linearly searched alias file with the | |
512 | # name SYSTEM_ALIASES_FILE. When this configuration is installed automatically, | |
513 | # the name gets inserted into this file from whatever is set in Exim's | |
514 | # build-time configuration. The default path is the traditional /etc/aliases. | |
515 | # If you install this configuration by hand, you need to specify the correct | |
516 | # path in the "data" setting below. | |
517 | # | |
518 | ##### NB You must ensure that the alias file exists. It used to be the case | |
519 | ##### NB that every Unix had that file, because it was the Sendmail default. | |
520 | ##### NB These days, there are systems that don't have it. Your aliases | |
521 | ##### NB file should at least contain an alias for "postmaster". | |
522 | # | |
523 | # If any of your aliases expand to pipes or files, you will need to set | |
524 | # up a user and a group for these deliveries to run under. You can do | |
525 | # this by uncommenting the "user" option below (changing the user name | |
526 | # as appropriate) and adding a "group" option if necessary. Alternatively, you | |
527 | # can specify "user" on the transports that are used. Note that the transports | |
528 | # listed below are the same as are used for .forward files; you might want | |
529 | # to set up different ones for pipe and file deliveries from aliases. | |
530 | ||
531 | system_aliases: | |
532 | driver = redirect | |
533 | allow_fail | |
534 | allow_defer | |
535 | data = ${lookup{$local_part}lsearch{SYSTEM_ALIASES_FILE}} | |
536 | # user = exim | |
537 | file_transport = address_file | |
538 | pipe_transport = address_pipe | |
539 | ||
540 | ||
541 | # This router handles forwarding using traditional .forward files in users' | |
542 | # home directories. If you want it also to allow mail filtering when a forward | |
543 | # file starts with the string "# Exim filter" or "# Sieve filter", uncomment | |
544 | # the "allow_filter" option. | |
545 | ||
546 | # If you want this router to treat local parts with suffixes introduced by "-" | |
547 | # or "+" characters as if the suffixes did not exist, uncomment the two local_ | |
548 | # part_suffix options. Then, for example, xxxx-foo@your.domain will be treated | |
549 | # in the same way as xxxx@your.domain by this router. You probably want to make | |
550 | # the same change to the localuser router. | |
551 | ||
552 | # The no_verify setting means that this router is skipped when Exim is | |
553 | # verifying addresses. Similarly, no_expn means that this router is skipped if | |
554 | # Exim is processing an EXPN command. | |
555 | ||
556 | # The check_ancestor option means that if the forward file generates an | |
557 | # address that is an ancestor of the current one, the current one gets | |
558 | # passed on instead. This covers the case where A is aliased to B and B | |
559 | # has a .forward file pointing to A. | |
560 | ||
561 | # The three transports specified at the end are those that are used when | |
562 | # forwarding generates a direct delivery to a file, or to a pipe, or sets | |
563 | # up an auto-reply, respectively. | |
564 | ||
565 | userforward: | |
566 | driver = redirect | |
567 | check_local_user | |
568 | # local_part_suffix = +* : -* | |
569 | # local_part_suffix_optional | |
570 | file = $home/.forward | |
571 | # allow_filter | |
572 | no_verify | |
573 | no_expn | |
574 | check_ancestor | |
575 | file_transport = address_file | |
576 | pipe_transport = address_pipe | |
577 | reply_transport = address_reply | |
578 | ||
579 | ||
580 | # This router matches local user mailboxes. If the router fails, the error | |
581 | # message is "Unknown user". | |
582 | ||
583 | # If you want this router to treat local parts with suffixes introduced by "-" | |
584 | # or "+" characters as if the suffixes did not exist, uncomment the two local_ | |
585 | # part_suffix options. Then, for example, xxxx-foo@your.domain will be treated | |
586 | # in the same way as xxxx@your.domain by this router. | |
587 | ||
588 | localuser: | |
589 | driver = accept | |
590 | check_local_user | |
591 | # local_part_suffix = +* : -* | |
592 | # local_part_suffix_optional | |
593 | transport = local_delivery | |
594 | cannot_route_message = Unknown user | |
595 | ||
596 | ||
597 | ||
598 | ###################################################################### | |
599 | # TRANSPORTS CONFIGURATION # | |
600 | ###################################################################### | |
601 | # ORDER DOES NOT MATTER # | |
602 | # Only one appropriate transport is called for each delivery. # | |
603 | ###################################################################### | |
604 | ||
605 | # A transport is used only when referenced from a router that successfully | |
606 | # handles an address. | |
607 | ||
608 | begin transports | |
609 | ||
610 | ||
611 | # This transport is used for delivering messages over SMTP connections. | |
612 | ||
613 | remote_smtp: | |
614 | driver = smtp | |
615 | ||
616 | ||
617 | # This transport is used for local delivery to user mailboxes in traditional | |
618 | # BSD mailbox format. By default it will be run under the uid and gid of the | |
619 | # local user, and requires the sticky bit to be set on the /var/mail directory. | |
620 | # Some systems use the alternative approach of running mail deliveries under a | |
621 | # particular group instead of using the sticky bit. The commented options below | |
622 | # show how this can be done. | |
623 | ||
624 | local_delivery: | |
625 | driver = appendfile | |
626 | file = /var/mail/$local_part | |
627 | delivery_date_add | |
628 | envelope_to_add | |
629 | return_path_add | |
630 | # group = mail | |
631 | # mode = 0660 | |
632 | ||
633 | ||
634 | # This transport is used for handling pipe deliveries generated by alias or | |
635 | # .forward files. If the pipe generates any standard output, it is returned | |
636 | # to the sender of the message as a delivery error. Set return_fail_output | |
637 | # instead of return_output if you want this to happen only when the pipe fails | |
638 | # to complete normally. You can set different transports for aliases and | |
639 | # forwards if you want to - see the references to address_pipe in the routers | |
640 | # section above. | |
641 | ||
642 | address_pipe: | |
643 | driver = pipe | |
644 | return_output | |
645 | ||
646 | ||
647 | # This transport is used for handling deliveries directly to files that are | |
648 | # generated by aliasing or forwarding. | |
649 | ||
650 | address_file: | |
651 | driver = appendfile | |
652 | delivery_date_add | |
653 | envelope_to_add | |
654 | return_path_add | |
655 | ||
656 | ||
657 | # This transport is used for handling autoreplies generated by the filtering | |
658 | # option of the userforward router. | |
659 | ||
660 | address_reply: | |
661 | driver = autoreply | |
662 | ||
663 | ||
664 | ||
665 | ###################################################################### | |
666 | # RETRY CONFIGURATION # | |
667 | ###################################################################### | |
668 | ||
669 | begin retry | |
670 | ||
671 | # This single retry rule applies to all domains and all errors. It specifies | |
672 | # retries every 15 minutes for 2 hours, then increasing retry intervals, | |
673 | # starting at 1 hour and increasing each time by a factor of 1.5, up to 16 | |
674 | # hours, then retries every 6 hours until 4 days have passed since the first | |
675 | # failed delivery. | |
676 | ||
677 | # Address or Domain Error Retries | |
678 | # ----------------- ----- ------- | |
679 | ||
680 | * * F,2h,15m; G,16h,1h,1.5; F,4d,6h | |
681 | ||
682 | ||
683 | ||
684 | ###################################################################### | |
685 | # REWRITE CONFIGURATION # | |
686 | ###################################################################### | |
687 | ||
688 | # There are no rewriting specifications in this default configuration file. | |
689 | ||
690 | begin rewrite | |
691 | ||
692 | ||
693 | ||
694 | ###################################################################### | |
695 | # AUTHENTICATION CONFIGURATION # | |
696 | ###################################################################### | |
697 | ||
6083aca0 TF |
698 | # The following authenticators support plaintext username/password |
699 | # authentication using the standard PLAIN mechanism and the traditional | |
700 | # but non-standard LOGIN mechanism, with Exim acting as the server. | |
701 | # PLAIN and LOGIN are enough to support most MUA software. | |
702 | # | |
703 | # These authenticators are not complete: you need to change the | |
704 | # server_condition settings to specify how passwords are verified. | |
705 | # They are set up to offer authentication to the client only if the | |
706 | # connection is encrypted with TLS, so you also need to add support | |
707 | # for TLS. See the global configuration options section at the start | |
708 | # of this file for more about TLS. | |
709 | # | |
710 | # The default RCPT ACL checks for successful authentication, and will accept | |
711 | # messages from authenticated users from anywhere on the Internet. | |
059ec3d9 PH |
712 | |
713 | begin authenticators | |
714 | ||
6083aca0 TF |
715 | # PLAIN authentication has no server prompts. The client sends its |
716 | # credentials in one lump, containing an authorization ID (which we do not | |
717 | # use), an authentication ID, and a password. The latter two appear as | |
718 | # $auth2 and $auth3 in the configuration and should be checked against a | |
719 | # valid username and password. In a real configuration you would typically | |
720 | # use $auth2 as a lookup key, and compare $auth3 against the result of the | |
721 | # lookup, perhaps using the crypteq{}{} condition. | |
722 | ||
723 | #PLAIN: | |
724 | # driver = plaintext | |
725 | # server_set_id = $auth2 | |
726 | # server_prompts = : | |
727 | # server_condition = Authentication is not yet configured | |
728 | # server_advertise_condition = ${if def:tls_cipher } | |
729 | ||
730 | # LOGIN authentication has traditional prompts and responses. There is no | |
731 | # authorization ID in this mechanism, so unlike PLAIN the username and | |
732 | # password are $auth1 and $auth2. Apart from that you can use the same | |
733 | # server_condition setting for both authenticators. | |
734 | ||
735 | #LOGIN: | |
736 | # driver = plaintext | |
737 | # server_set_id = $auth1 | |
738 | # server_prompts = <| Username: | Password: | |
739 | # server_condition = Authentication is not yet configured | |
740 | # server_advertise_condition = ${if def:tls_cipher } | |
059ec3d9 PH |
741 | |
742 | ||
743 | ###################################################################### | |
744 | # CONFIGURATION FOR local_scan() # | |
745 | ###################################################################### | |
746 | ||
747 | # If you have built Exim to include a local_scan() function that contains | |
748 | # tables for private options, you can define those options here. Remember to | |
749 | # uncomment the "begin" line. It is commented by default because it provokes | |
750 | # an error with Exim binaries that are not built with LOCAL_SCAN_HAS_OPTIONS | |
751 | # set in the Local/Makefile. | |
752 | ||
753 | # begin local_scan | |
754 | ||
755 | ||
756 | # End of Exim configuration file |