Mercurial > dovecot > original-hg > dovecot-1.2
annotate dovecot-example.conf @ 817:86cf24da85f1 HEAD
Added :INDEX=<dir> for both Maildir and mbox to specify different location
where to store index files. This would allow keeping mailboxes accessible
through NFS but still keep the indexes in fast local disk.
Did also some other related cleanups and minor fixes.
| author | Timo Sirainen <tss@iki.fi> |
|---|---|
| date | Fri, 20 Dec 2002 09:53:51 +0200 |
| parents | ef64c9a50326 |
| children | 6377d4f7a31c |
| rev | line source |
|---|---|
| 0 | 1 ## Dovecot 1.0 configuration file |
| 2 | |
| 3 # Default values are shown after each value, it's not required to uncomment | |
| 435 | 4 # any of the lines. Exception to this are paths, they're just examples |
| 5 # with real defaults being based on configure options. The paths listed here | |
| 6 # are for configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var | |
|
657
85a888d2766e
Added script to easily generate self-signed certificate.
Timo Sirainen <tss@iki.fi>
parents:
644
diff
changeset
|
7 # --with-ssldir=/etc/ssl |
| 0 | 8 |
| 9 # Port to listen in for IMAP connections. This port is used for TLS | |
| 10 # connections as well. Setting it to 0 disables it. | |
| 11 #imap_port = 143 | |
| 12 | |
| 13 # Port to listen in for SSL IMAP connections. Setting it to 0 disables it. | |
| 14 #imaps_port = 993 | |
| 15 | |
|
780
1cc947617c8b
imap_listen and imaps_listen accepts now "*" as "all IPv4 interfaces" and
Timo Sirainen <tss@iki.fi>
parents:
779
diff
changeset
|
16 # IP or host address where to listen in for IMAP connections. It's not |
|
1cc947617c8b
imap_listen and imaps_listen accepts now "*" as "all IPv4 interfaces" and
Timo Sirainen <tss@iki.fi>
parents:
779
diff
changeset
|
17 # possible to specify multiple addresses. "*" listens in all IPv4 interfaces. |
|
1cc947617c8b
imap_listen and imaps_listen accepts now "*" as "all IPv4 interfaces" and
Timo Sirainen <tss@iki.fi>
parents:
779
diff
changeset
|
18 # "::" listens in all IPv6 interfaces, but may also listen in all IPv4 |
|
1cc947617c8b
imap_listen and imaps_listen accepts now "*" as "all IPv4 interfaces" and
Timo Sirainen <tss@iki.fi>
parents:
779
diff
changeset
|
19 # interfaces depending on the operating system. |
|
1cc947617c8b
imap_listen and imaps_listen accepts now "*" as "all IPv4 interfaces" and
Timo Sirainen <tss@iki.fi>
parents:
779
diff
changeset
|
20 #imap_listen = * |
| 0 | 21 |
| 22 # IP or host address where to listen in for SSL IMAP connections. Defaults | |
| 23 # to imap_listen if not specified. | |
| 24 #imaps_listen = | |
| 25 | |
| 666 | 26 # Disable SSL support. |
| 27 #ssl_disable = no | |
| 28 | |
| 519 | 29 # PEM encoded X.509 SSL/TLS certificate and private key. They're opened before |
|
518
1f9b96080525
Updated SSL certificate comments.
Timo Sirainen <tss@iki.fi>
parents:
472
diff
changeset
|
30 # dropping root privileges, so keep the key file unreadable by anyone but |
|
657
85a888d2766e
Added script to easily generate self-signed certificate.
Timo Sirainen <tss@iki.fi>
parents:
644
diff
changeset
|
31 # root. Included doc/mkcert.sh can be used to easily generate self-signed |
|
85a888d2766e
Added script to easily generate self-signed certificate.
Timo Sirainen <tss@iki.fi>
parents:
644
diff
changeset
|
32 # certificate, just make sure to update the domains in dovecot-openssl.cnf |
| 0 | 33 #ssl_cert_file = /etc/ssl/certs/imapd.pem |
| 34 #ssl_key_file = /etc/ssl/private/imapd.pem | |
| 35 | |
|
615
0d852af6842e
Master process generates DH/RSA parameters now and stores them into file
Timo Sirainen <tss@iki.fi>
parents:
614
diff
changeset
|
36 # SSL parameter file. Master process generates this file for login processes. |
|
0d852af6842e
Master process generates DH/RSA parameters now and stores them into file
Timo Sirainen <tss@iki.fi>
parents:
614
diff
changeset
|
37 # It contains Diffie Hellman and RSA parameters. |
|
0d852af6842e
Master process generates DH/RSA parameters now and stores them into file
Timo Sirainen <tss@iki.fi>
parents:
614
diff
changeset
|
38 #ssl_parameters_file = /var/run/dovecot/ssl-parameters.dat |
|
0d852af6842e
Master process generates DH/RSA parameters now and stores them into file
Timo Sirainen <tss@iki.fi>
parents:
614
diff
changeset
|
39 |
|
0d852af6842e
Master process generates DH/RSA parameters now and stores them into file
Timo Sirainen <tss@iki.fi>
parents:
614
diff
changeset
|
40 # How often to regenerate the SSL parameters file. Generation is quite CPU |
|
0d852af6842e
Master process generates DH/RSA parameters now and stores them into file
Timo Sirainen <tss@iki.fi>
parents:
614
diff
changeset
|
41 # intensive operation. The value is in hours, 0 disables regeneration |
|
0d852af6842e
Master process generates DH/RSA parameters now and stores them into file
Timo Sirainen <tss@iki.fi>
parents:
614
diff
changeset
|
42 # entirely. |
|
0d852af6842e
Master process generates DH/RSA parameters now and stores them into file
Timo Sirainen <tss@iki.fi>
parents:
614
diff
changeset
|
43 #ssl_parameters_regenerate = 24 |
|
0d852af6842e
Master process generates DH/RSA parameters now and stores them into file
Timo Sirainen <tss@iki.fi>
parents:
614
diff
changeset
|
44 |
| 0 | 45 # Disable LOGIN command and all other plaintext authentications unless |
| 46 # SSL/TLS is used (LOGINDISABLED capability) | |
| 47 #disable_plaintext_auth = no | |
| 48 | |
|
35
b420373f88f6
Added log_path and log_timestamp settings to config file. Removed -l command
Timo Sirainen <tss@iki.fi>
parents:
27
diff
changeset
|
49 # Use this logfile instead of syslog() |
|
b420373f88f6
Added log_path and log_timestamp settings to config file. Removed -l command
Timo Sirainen <tss@iki.fi>
parents:
27
diff
changeset
|
50 #log_path = |
|
b420373f88f6
Added log_path and log_timestamp settings to config file. Removed -l command
Timo Sirainen <tss@iki.fi>
parents:
27
diff
changeset
|
51 |
|
811
664de3231e33
Added info_log_file setting and i_info() function to write to it. Default is
Timo Sirainen <tss@iki.fi>
parents:
788
diff
changeset
|
52 # For informational messages, use this logfile instead of the default |
|
664de3231e33
Added info_log_file setting and i_info() function to write to it. Default is
Timo Sirainen <tss@iki.fi>
parents:
788
diff
changeset
|
53 #info_log_path = |
|
664de3231e33
Added info_log_file setting and i_info() function to write to it. Default is
Timo Sirainen <tss@iki.fi>
parents:
788
diff
changeset
|
54 |
|
35
b420373f88f6
Added log_path and log_timestamp settings to config file. Removed -l command
Timo Sirainen <tss@iki.fi>
parents:
27
diff
changeset
|
55 # Prefix for each line written to log file. % codes are in strftime(3) |
|
b420373f88f6
Added log_path and log_timestamp settings to config file. Removed -l command
Timo Sirainen <tss@iki.fi>
parents:
27
diff
changeset
|
56 # format. Note the extra space at the end of line. |
|
b420373f88f6
Added log_path and log_timestamp settings to config file. Removed -l command
Timo Sirainen <tss@iki.fi>
parents:
27
diff
changeset
|
57 #log_timestamp = %b %d %H:%M:%S |
|
b420373f88f6
Added log_path and log_timestamp settings to config file. Removed -l command
Timo Sirainen <tss@iki.fi>
parents:
27
diff
changeset
|
58 |
| 0 | 59 ## |
| 60 ## Login process | |
| 61 ## | |
| 62 | |
| 63 # Executable location | |
|
661
b88b5488bcfd
updated lib paths to libexec ones
Timo Sirainen <tss@iki.fi>
parents:
657
diff
changeset
|
64 #login_executable = /usr/libexec/dovecot/imap-login |
| 0 | 65 |
| 66 # User to use for imap-login process | |
| 67 #login_user = imapd | |
| 68 | |
|
722
0438621d25ff
Added virtual memory size limits to processes. Default values are pretty
Timo Sirainen <tss@iki.fi>
parents:
666
diff
changeset
|
69 # Set max. process size in megabytes. If you don't use |
|
0438621d25ff
Added virtual memory size limits to processes. Default values are pretty
Timo Sirainen <tss@iki.fi>
parents:
666
diff
changeset
|
70 # login_process_per_connection you might need to grow this. |
|
0438621d25ff
Added virtual memory size limits to processes. Default values are pretty
Timo Sirainen <tss@iki.fi>
parents:
666
diff
changeset
|
71 #login_process_size = 16 |
|
0438621d25ff
Added virtual memory size limits to processes. Default values are pretty
Timo Sirainen <tss@iki.fi>
parents:
666
diff
changeset
|
72 |
| 0 | 73 # Directory where imap-auth places authentication UNIX sockets which login |
| 74 # needs to be able to connect to. The sockets are created when running as | |
| 75 # root, so you don't need to give imap-auth any access for it. | |
| 76 #login_dir = /var/run/dovecot/login | |
| 77 | |
| 435 | 78 # chroot imap-login process to the login_dir. Only reason not to do this |
| 0 | 79 # is if you wish to run the whole imapd without roots. |
| 80 #login_chroot = yes | |
| 81 | |
|
613
1906116a62ce
Finally support for handling each login connection in it's own process.
Timo Sirainen <tss@iki.fi>
parents:
600
diff
changeset
|
82 # Should each login be processed in it's own process (yes), or should one |
|
1906116a62ce
Finally support for handling each login connection in it's own process.
Timo Sirainen <tss@iki.fi>
parents:
600
diff
changeset
|
83 # login process be allowed to process multiple connections (no)? Yes is more |
|
1906116a62ce
Finally support for handling each login connection in it's own process.
Timo Sirainen <tss@iki.fi>
parents:
600
diff
changeset
|
84 # secure, espcially with SSL/TLS enabled. No is faster since there's no need |
|
1906116a62ce
Finally support for handling each login connection in it's own process.
Timo Sirainen <tss@iki.fi>
parents:
600
diff
changeset
|
85 # to create processes all the time. |
|
1906116a62ce
Finally support for handling each login connection in it's own process.
Timo Sirainen <tss@iki.fi>
parents:
600
diff
changeset
|
86 #login_process_per_connection = yes |
|
1906116a62ce
Finally support for handling each login connection in it's own process.
Timo Sirainen <tss@iki.fi>
parents:
600
diff
changeset
|
87 |
|
1906116a62ce
Finally support for handling each login connection in it's own process.
Timo Sirainen <tss@iki.fi>
parents:
600
diff
changeset
|
88 # Number of imap-login processes to create. If login_process_per_user is |
|
1906116a62ce
Finally support for handling each login connection in it's own process.
Timo Sirainen <tss@iki.fi>
parents:
600
diff
changeset
|
89 # yes, this is the number of extra processes waiting for users to log in. |
|
1906116a62ce
Finally support for handling each login connection in it's own process.
Timo Sirainen <tss@iki.fi>
parents:
600
diff
changeset
|
90 #login_processes_count = 3 |
| 0 | 91 |
|
614
e60620644af3
login_process_per_connection = yes scales now better when multiple users are
Timo Sirainen <tss@iki.fi>
parents:
613
diff
changeset
|
92 # Maximum number of extra login processes to create. The extra process count |
|
e60620644af3
login_process_per_connection = yes scales now better when multiple users are
Timo Sirainen <tss@iki.fi>
parents:
613
diff
changeset
|
93 # usually stays at login_processes_count, but when multiple users start logging |
|
e60620644af3
login_process_per_connection = yes scales now better when multiple users are
Timo Sirainen <tss@iki.fi>
parents:
613
diff
changeset
|
94 # in at the same time more extra processes are created. To prevent fork-bombing |
|
e60620644af3
login_process_per_connection = yes scales now better when multiple users are
Timo Sirainen <tss@iki.fi>
parents:
613
diff
changeset
|
95 # we check only once in a second if new processes should be created - if all |
|
e60620644af3
login_process_per_connection = yes scales now better when multiple users are
Timo Sirainen <tss@iki.fi>
parents:
613
diff
changeset
|
96 # of them are used at the time, we double their amount until limit set by this |
|
e60620644af3
login_process_per_connection = yes scales now better when multiple users are
Timo Sirainen <tss@iki.fi>
parents:
613
diff
changeset
|
97 # setting is reached. This setting is used only if login_process_per_use is yes. |
|
e60620644af3
login_process_per_connection = yes scales now better when multiple users are
Timo Sirainen <tss@iki.fi>
parents:
613
diff
changeset
|
98 #login_max_processes_count = 128 |
|
e60620644af3
login_process_per_connection = yes scales now better when multiple users are
Timo Sirainen <tss@iki.fi>
parents:
613
diff
changeset
|
99 |
| 0 | 100 # Maximum number of connections allowed in login state. When this limit is |
|
613
1906116a62ce
Finally support for handling each login connection in it's own process.
Timo Sirainen <tss@iki.fi>
parents:
600
diff
changeset
|
101 # reached, the oldest connections are dropped. If login_process_per_user |
|
1906116a62ce
Finally support for handling each login connection in it's own process.
Timo Sirainen <tss@iki.fi>
parents:
600
diff
changeset
|
102 # is no, this is a per-process value, so the absolute maximum number of users |
|
1906116a62ce
Finally support for handling each login connection in it's own process.
Timo Sirainen <tss@iki.fi>
parents:
600
diff
changeset
|
103 # logging in actually login_processes_count * max_logging_users. |
| 0 | 104 #max_logging_users = 256 |
| 105 | |
| 106 ## | |
| 107 ## IMAP process | |
| 108 ## | |
| 109 | |
| 110 # Executable location | |
|
661
b88b5488bcfd
updated lib paths to libexec ones
Timo Sirainen <tss@iki.fi>
parents:
657
diff
changeset
|
111 #imap_executable = /usr/libexec/dovecot/imap |
| 0 | 112 |
|
722
0438621d25ff
Added virtual memory size limits to processes. Default values are pretty
Timo Sirainen <tss@iki.fi>
parents:
666
diff
changeset
|
113 # Set max. process size in megabytes. Most of the memory goes to mmap()ing |
|
0438621d25ff
Added virtual memory size limits to processes. Default values are pretty
Timo Sirainen <tss@iki.fi>
parents:
666
diff
changeset
|
114 # files, so it shouldn't harm much even if this limit is set pretty high. |
|
0438621d25ff
Added virtual memory size limits to processes. Default values are pretty
Timo Sirainen <tss@iki.fi>
parents:
666
diff
changeset
|
115 #imap_process_size = 256 |
|
0438621d25ff
Added virtual memory size limits to processes. Default values are pretty
Timo Sirainen <tss@iki.fi>
parents:
666
diff
changeset
|
116 |
| 0 | 117 # Maximum number of running imap processes. When this limit is reached, |
| 118 # new users aren't allowed to log in. | |
| 119 #max_imap_processes = 1024 | |
| 120 | |
|
596
ab3590c3a7d9
Added verbose_proctitle setting: Show more verbose process titles (in ps).
Timo Sirainen <tss@iki.fi>
parents:
519
diff
changeset
|
121 # Show more verbose process titles (in ps). Currently shows user name and |
|
ab3590c3a7d9
Added verbose_proctitle setting: Show more verbose process titles (in ps).
Timo Sirainen <tss@iki.fi>
parents:
519
diff
changeset
|
122 # IP address. Useful for seeing who are actually using the IMAP processes |
|
ab3590c3a7d9
Added verbose_proctitle setting: Show more verbose process titles (in ps).
Timo Sirainen <tss@iki.fi>
parents:
519
diff
changeset
|
123 # (eg. shared mailboxes or if same uid is used for multiple accounts). |
|
ab3590c3a7d9
Added verbose_proctitle setting: Show more verbose process titles (in ps).
Timo Sirainen <tss@iki.fi>
parents:
519
diff
changeset
|
124 #verbose_proctitle = no |
|
ab3590c3a7d9
Added verbose_proctitle setting: Show more verbose process titles (in ps).
Timo Sirainen <tss@iki.fi>
parents:
519
diff
changeset
|
125 |
| 0 | 126 # Valid UID/GID ranges for imap users, defaults to 500 and above. |
| 127 # Note that denying root logins is hardcoded to imap-master binary and | |
| 128 # can't be done even if first_valid_uid is set to 0. | |
| 129 #first_valid_uid = 500 | |
| 130 #last_valid_uid = 0 | |
| 131 | |
| 132 #first_valid_gid = 1 | |
| 133 #last_valid_gid = 0 | |
| 134 | |
| 135 # ':' separated list of directories under which chrooting is allowed for imap | |
| 136 # processes (ie. /var/mail will allow chrooting to /var/mail/foo/bar too). | |
| 137 # WARNING: Never add directories here which local users can modify, that | |
| 138 # may lead to root exploit. Usually this should be done only if you don't | |
| 139 # allow shell access for users. | |
| 140 #valid_chroot_dirs = | |
| 141 | |
|
779
f126b666859e
New setting: default_mail_env which can be used to specify where to find
Timo Sirainen <tss@iki.fi>
parents:
722
diff
changeset
|
142 # Default MAIL environment to use when it's not set. By leaving this empty |
|
f126b666859e
New setting: default_mail_env which can be used to specify where to find
Timo Sirainen <tss@iki.fi>
parents:
722
diff
changeset
|
143 # dovecot tries to do some automatic detection as described in |
|
813
493bc8da9e80
default_mail_env behaviour changed. We use %u instead of $U now. Added also
Timo Sirainen <tss@iki.fi>
parents:
811
diff
changeset
|
144 # doc/mail-storages.txt. There's a few special variables you can use: |
|
493bc8da9e80
default_mail_env behaviour changed. We use %u instead of $U now. Added also
Timo Sirainen <tss@iki.fi>
parents:
811
diff
changeset
|
145 # |
|
493bc8da9e80
default_mail_env behaviour changed. We use %u instead of $U now. Added also
Timo Sirainen <tss@iki.fi>
parents:
811
diff
changeset
|
146 # %u - username |
|
493bc8da9e80
default_mail_env behaviour changed. We use %u instead of $U now. Added also
Timo Sirainen <tss@iki.fi>
parents:
811
diff
changeset
|
147 # %n - user part in user@domain, same as %u if there's no domain |
|
493bc8da9e80
default_mail_env behaviour changed. We use %u instead of $U now. Added also
Timo Sirainen <tss@iki.fi>
parents:
811
diff
changeset
|
148 # %d - domain part in user@domain, empty if user there's no domain |
|
493bc8da9e80
default_mail_env behaviour changed. We use %u instead of $U now. Added also
Timo Sirainen <tss@iki.fi>
parents:
811
diff
changeset
|
149 # %h - home directory |
|
493bc8da9e80
default_mail_env behaviour changed. We use %u instead of $U now. Added also
Timo Sirainen <tss@iki.fi>
parents:
811
diff
changeset
|
150 # |
|
493bc8da9e80
default_mail_env behaviour changed. We use %u instead of $U now. Added also
Timo Sirainen <tss@iki.fi>
parents:
811
diff
changeset
|
151 # You can also limit a width of string by giving the number of max. characters |
|
493bc8da9e80
default_mail_env behaviour changed. We use %u instead of $U now. Added also
Timo Sirainen <tss@iki.fi>
parents:
811
diff
changeset
|
152 # after the '%' character. For example %1u gives the first character of |
|
493bc8da9e80
default_mail_env behaviour changed. We use %u instead of $U now. Added also
Timo Sirainen <tss@iki.fi>
parents:
811
diff
changeset
|
153 # username. Some examples: |
|
493bc8da9e80
default_mail_env behaviour changed. We use %u instead of $U now. Added also
Timo Sirainen <tss@iki.fi>
parents:
811
diff
changeset
|
154 # |
|
493bc8da9e80
default_mail_env behaviour changed. We use %u instead of $U now. Added also
Timo Sirainen <tss@iki.fi>
parents:
811
diff
changeset
|
155 # maildir:/var/mail/%1u/%u/Maildir |
|
815
ef64c9a50326
Support for separate location of mbox INBOX folder.
Timo Sirainen <tss@iki.fi>
parents:
813
diff
changeset
|
156 # mbox:~/mail/:INBOX=/var/mail/%u |
|
817
86cf24da85f1
Added :INDEX=<dir> for both Maildir and mbox to specify different location
Timo Sirainen <tss@iki.fi>
parents:
815
diff
changeset
|
157 # mbox:/var/mail/%d/%n/:INDEX=/var/indexes/%d/%n |
|
813
493bc8da9e80
default_mail_env behaviour changed. We use %u instead of $U now. Added also
Timo Sirainen <tss@iki.fi>
parents:
811
diff
changeset
|
158 # |
|
779
f126b666859e
New setting: default_mail_env which can be used to specify where to find
Timo Sirainen <tss@iki.fi>
parents:
722
diff
changeset
|
159 #default_mail_env = |
|
f126b666859e
New setting: default_mail_env which can be used to specify where to find
Timo Sirainen <tss@iki.fi>
parents:
722
diff
changeset
|
160 |
|
462
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
161 # Space-separated list of fields to cache for all mails. Currently these |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
162 # fields are allowed followed by a list of commands they speed up: |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
163 # |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
164 # Envelope - FETCH ENVELOPE and SEARCH FROM, TO, CC, BCC, SUBJECT, |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
165 # SENTBEFORE, SENTON, SENTSINCE, HEADER MESSAGE-ID, |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
166 # HEADER IN-REPLY-TO |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
167 # Body - FETCH BODY |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
168 # Bodystructure - FETCH BODY, BODYSTRUCTURE |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
169 # MessagePart - FETCH BODY[1.2.3] (ie. body parts), RFC822.SIZE, |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
170 # SEARCH SMALLER, LARGER, also speeds up BODY/BODYSTRUCTURE |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
171 # generation. This is always set with mbox mailboxes, and |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
172 # also default with Maildir. |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
173 # |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
174 # Different IMAP clients work in different ways, that's why Dovecot by default |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
175 # only caches MessagePart which speeds up most operations. Whenever client |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
176 # does something where caching could be used, the field is automatically marked |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
177 # to be cached later. For example after FETCH BODY the BODY will be cached |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
178 # for all new messages. Normally you should leave this alone, unless you know |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
179 # what most of your IMAP clients are. Caching more fields than needed makes |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
180 # the index files larger and generate useless I/O. |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
181 # |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
182 # With maildir there's one extra optimization - if nothing is cached, indexing |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
183 # the maildir becomes much faster since it's not opening any of the mail files. |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
184 # This could be useful if your IMAP clients access only new mails. |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
185 |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
186 #mail_cache_fields = MessagePart |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
187 |
|
600
3b44bc64afd4
mailbox_check_interval setting: Dovecot can notify client of new mail in
Timo Sirainen <tss@iki.fi>
parents:
596
diff
changeset
|
188 # Dovecot can notify client of new mail in selected mailbox soon after it's |
|
3b44bc64afd4
mailbox_check_interval setting: Dovecot can notify client of new mail in
Timo Sirainen <tss@iki.fi>
parents:
596
diff
changeset
|
189 # received. This setting specifies the minimum interval in seconds between |
|
3b44bc64afd4
mailbox_check_interval setting: Dovecot can notify client of new mail in
Timo Sirainen <tss@iki.fi>
parents:
596
diff
changeset
|
190 # new mail notifications to client - internally they may be checked more or |
|
3b44bc64afd4
mailbox_check_interval setting: Dovecot can notify client of new mail in
Timo Sirainen <tss@iki.fi>
parents:
596
diff
changeset
|
191 # less often. Setting this to 0 disables the checking. |
|
788
5b2a247ed361
mailbox_check_interval is now disabled by default, at least Evolution breaks
Timo Sirainen <tss@iki.fi>
parents:
780
diff
changeset
|
192 # NOTE: Evolution client breaks with this option when it's trying to APPEND. |
|
5b2a247ed361
mailbox_check_interval is now disabled by default, at least Evolution breaks
Timo Sirainen <tss@iki.fi>
parents:
780
diff
changeset
|
193 #mailbox_check_interval = 0 |
|
600
3b44bc64afd4
mailbox_check_interval setting: Dovecot can notify client of new mail in
Timo Sirainen <tss@iki.fi>
parents:
596
diff
changeset
|
194 |
|
462
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
195 # Space-separated list of fields that Dovecot should never set to be cached. |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
196 # Useful if you want to save disk space at the cost of more I/O when the fields |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
197 # needed. |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
198 #mail_never_cache_fields = |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
199 |
|
472
2fa0bfb65268
Added setting mail_save_crlf. Few other settings cleanups.
Timo Sirainen <tss@iki.fi>
parents:
462
diff
changeset
|
200 # Save mails with CR+LF instead of plain LF. This makes sending those mails |
|
2fa0bfb65268
Added setting mail_save_crlf. Few other settings cleanups.
Timo Sirainen <tss@iki.fi>
parents:
462
diff
changeset
|
201 # take less CPU, especially with sendfile() syscall with Linux and FreeBSD. |
|
2fa0bfb65268
Added setting mail_save_crlf. Few other settings cleanups.
Timo Sirainen <tss@iki.fi>
parents:
462
diff
changeset
|
202 # But it also creates a bit more disk I/O which may just make it slower. |
|
2fa0bfb65268
Added setting mail_save_crlf. Few other settings cleanups.
Timo Sirainen <tss@iki.fi>
parents:
462
diff
changeset
|
203 #mail_save_crlf = no |
|
2fa0bfb65268
Added setting mail_save_crlf. Few other settings cleanups.
Timo Sirainen <tss@iki.fi>
parents:
462
diff
changeset
|
204 |
|
644
415498fa78d6
mail_read_mmaped: Use mmap() instead of read() to read mail files. read()
Timo Sirainen <tss@iki.fi>
parents:
643
diff
changeset
|
205 # Use mmap() instead of read() to read mail files. read() seems to be a bit |
|
415498fa78d6
mail_read_mmaped: Use mmap() instead of read() to read mail files. read()
Timo Sirainen <tss@iki.fi>
parents:
643
diff
changeset
|
206 # faster with my Linux/x86 and it's better with NFS, so that's the default. |
|
415498fa78d6
mail_read_mmaped: Use mmap() instead of read() to read mail files. read()
Timo Sirainen <tss@iki.fi>
parents:
643
diff
changeset
|
207 #mail_read_mmaped = no |
|
415498fa78d6
mail_read_mmaped: Use mmap() instead of read() to read mail files. read()
Timo Sirainen <tss@iki.fi>
parents:
643
diff
changeset
|
208 |
| 0 | 209 # Copy mail to another folders using hard links. This is much faster than |
| 210 # actually copying the file. Only problem with it is that if either of the | |
| 211 # mails are modified directly both will change. This isn't a problem with | |
| 212 # IMAP however since it offers no way to modify the existing mails. Also | |
| 213 # at least mutt modifies mails by deleting the old one and inserting a new | |
| 214 # modified mail. So if performance matters at all you should turn this on. | |
| 215 #maildir_copy_with_hardlinks = no | |
| 216 | |
| 217 # Check if mails' content has been changed by external programs. This slows | |
| 218 # down things as extra stat() needs to be called for each file. | |
| 219 #maildir_check_content_changes = no | |
| 220 | |
|
643
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
221 # Which locking methods to use for locking mbox. All of them are used by |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
222 # default. flock is ignored in systems which don't have it. Note that the |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
223 # order of fcntl and flock are important to prevent deadlocks if they're both |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
224 # also used by other programs accessing the mailbox. Dotlock file is always |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
225 # created first. |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
226 #mbox_locks = dotlock fcntl flock |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
227 |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
228 # Should we create dotlock file even when we want only a read-lock? Setting |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
229 # this to yes hurts the performance when the mailbox is accessed simultaneously |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
230 # by multiple processes, but it's needed for reliable reading if no other |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
231 # locking methods are available. |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
232 #mbox_read_dotlock = no |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
233 |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
234 # Maximum time in seconds to wait for lock (all of them) before aborting. |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
235 #mbox_lock_timeout = 300 |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
236 |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
237 # If dotlock exists but the mailbox isn't modified in any way, override the |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
238 # lock file after this many seconds. |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
239 #mbox_dotlock_change_timeout = 30 |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
240 |
|
101
edc37d046b08
Added overwrite_incompatible_index setting. Also we now try to use only
Timo Sirainen <tss@iki.fi>
parents:
35
diff
changeset
|
241 # If main index file is incompatible with us, should we overwrite it or |
|
edc37d046b08
Added overwrite_incompatible_index setting. Also we now try to use only
Timo Sirainen <tss@iki.fi>
parents:
35
diff
changeset
|
242 # create a new index with another name. Unless you are running Dovecot in |
|
edc37d046b08
Added overwrite_incompatible_index setting. Also we now try to use only
Timo Sirainen <tss@iki.fi>
parents:
35
diff
changeset
|
243 # multiple computers with different architectures accessing the same |
|
edc37d046b08
Added overwrite_incompatible_index setting. Also we now try to use only
Timo Sirainen <tss@iki.fi>
parents:
35
diff
changeset
|
244 # mailboxes (eg. via NFS), it's safe to set this "yes". |
|
edc37d046b08
Added overwrite_incompatible_index setting. Also we now try to use only
Timo Sirainen <tss@iki.fi>
parents:
35
diff
changeset
|
245 #overwrite_incompatible_index = no |
|
edc37d046b08
Added overwrite_incompatible_index setting. Also we now try to use only
Timo Sirainen <tss@iki.fi>
parents:
35
diff
changeset
|
246 |
| 0 | 247 # umask to use for mail files and directories |
| 248 #umask = 0077 | |
| 249 | |
| 250 ## | |
| 251 ## Authentication processes | |
| 252 ## | |
| 253 | |
| 254 # You can have multiple processes; each time "auth = xx" is seen, a new | |
| 255 # process definition is started. The point of multiple processes is to be | |
| 256 # able to set stricter permissions to others. For example, plain/PAM | |
| 257 # authentication requires roots, but if you also use digest-md5 authentication | |
| 258 # for some users, you can authenticate them without any privileges in a | |
| 259 # separate auth process. Just remember that only one auth process is asked | |
| 260 # for the password, so you can't have different passwords with different | |
| 261 # processes (unless they have different auth methods, and you're ok with | |
| 262 # having different password for each method). | |
| 263 | |
| 264 # Authentication process name. | |
| 265 auth = default | |
| 266 | |
| 284 | 267 # Authentication methods this process allows separated with a space. |
| 268 # Currently supported: plain digest-md5 | |
| 0 | 269 auth_methods = plain |
| 270 | |
| 271 # Space separated list of realms with authentication methods that need them. | |
| 272 # This is usually empty or the host name of the server (eg. | |
| 273 # mail.mycompany.com). | |
| 274 # - plain auth checks the password from all realms specified in here | |
| 275 # - digest-md5 must have the password added for each realm separately, and | |
| 276 # many clients simply use the first realm listed here. so if you really | |
| 277 # need to add more realms, add them to end of the list. | |
| 278 #auth_realms = | |
| 279 | |
| 280 # Where the user information and passwords are stored into: | |
| 281 # passwd: /etc/passwd or similiar, using getpwnam() | |
| 282 # shadow: /etc/shadow or similiar, using getspnam() | |
| 283 # pam: PAM authentication | |
| 284 # passwd-file /etc/passwd.imap: /etc/passwd-like file. Supports digest-md5 | |
| 285 # style passwords | |
|
280
fa2d1a1d025e
vpopmail authentication. compiles, not tested if it really works.
Timo Sirainen <tss@iki.fi>
parents:
101
diff
changeset
|
286 # vpopmail: vpopmail authentication |
| 27 | 287 auth_userinfo = pam |
| 0 | 288 |
| 289 # Executable location | |
|
661
b88b5488bcfd
updated lib paths to libexec ones
Timo Sirainen <tss@iki.fi>
parents:
657
diff
changeset
|
290 #auth_executable = /usr/libexec/dovecot/imap-auth |
| 0 | 291 |
|
722
0438621d25ff
Added virtual memory size limits to processes. Default values are pretty
Timo Sirainen <tss@iki.fi>
parents:
666
diff
changeset
|
292 # Set max. process size in megabytes. |
|
0438621d25ff
Added virtual memory size limits to processes. Default values are pretty
Timo Sirainen <tss@iki.fi>
parents:
666
diff
changeset
|
293 #auth_process_size = 256 |
|
0438621d25ff
Added virtual memory size limits to processes. Default values are pretty
Timo Sirainen <tss@iki.fi>
parents:
666
diff
changeset
|
294 |
| 0 | 295 # User to use for the process. Only shadow and pam authentication requires |
| 296 # roots, so use something else if possible. | |
| 297 auth_user = root | |
| 298 | |
| 435 | 299 # Directory where to chroot the process. Most authentication backends don't |
| 300 # work if this is set, and there's no point chrooting if auth_user is root. | |
| 0 | 301 #auth_chroot = |
| 302 | |
| 303 # Number of authentication processes to create | |
| 304 #auth_count = 1 | |
| 305 | |
| 306 | |
| 307 # digest-md5 authentication process. It requires special MD5 passwords which | |
| 308 # /etc/shadow and PAM doesn't support, so we never need roots to handle it. | |
| 309 # Note that the passwd-file is opened before chrooting and dropping root | |
| 310 # privileges, so it may be 0600-root owned file. | |
| 311 | |
| 312 #auth = digest_md5 | |
| 313 #auth_methods = digest-md5 | |
| 314 #auth_realms = | |
| 315 #auth_userinfo = passwd-file /etc/passwd.imap | |
| 316 #auth_user = imapauth | |
| 317 #auth_chroot = /var/run/dovecot/auth | |
| 318 | |
| 319 # if you plan to use only passwd-file, you don't need the two auth processes, | |
| 320 # simply set "auth_methods = plain digest-md5" |