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