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