Mercurial > dovecot > original-hg > dovecot-1.2
annotate dovecot-example.conf @ 956:26cafa3dc09c HEAD
minor optimization
| author | Timo Sirainen <tss@iki.fi> |
|---|---|
| date | Sun, 12 Jan 2003 01:49:45 +0200 |
| parents | 38b3bc6ddcc4 |
| children | d3433363bcaa |
| 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 |
|
872
6377d4f7a31c
Added base_dir setting, so the configure time --localstatedir can be
Timo Sirainen <tss@iki.fi>
parents:
817
diff
changeset
|
9 # Base directory where to store runtime data. |
|
6377d4f7a31c
Added base_dir setting, so the configure time --localstatedir can be
Timo Sirainen <tss@iki.fi>
parents:
817
diff
changeset
|
10 #base_dir = /var/run/dovecot/ |
|
6377d4f7a31c
Added base_dir setting, so the configure time --localstatedir can be
Timo Sirainen <tss@iki.fi>
parents:
817
diff
changeset
|
11 |
| 0 | 12 # Port to listen in for IMAP connections. This port is used for TLS |
| 13 # connections as well. Setting it to 0 disables it. | |
| 14 #imap_port = 143 | |
| 15 | |
| 16 # Port to listen in for SSL IMAP connections. Setting it to 0 disables it. | |
| 17 #imaps_port = 993 | |
| 18 | |
|
780
1cc947617c8b
imap_listen and imaps_listen accepts now "*" as "all IPv4 interfaces" and
Timo Sirainen <tss@iki.fi>
parents:
779
diff
changeset
|
19 # 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
|
20 # 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
|
21 # "::" 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
|
22 # 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
|
23 #imap_listen = * |
| 0 | 24 |
| 25 # IP or host address where to listen in for SSL IMAP connections. Defaults | |
| 26 # to imap_listen if not specified. | |
| 27 #imaps_listen = | |
| 28 | |
| 666 | 29 # Disable SSL support. |
| 30 #ssl_disable = no | |
| 31 | |
| 519 | 32 # 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
|
33 # 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
|
34 # 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
|
35 # certificate, just make sure to update the domains in dovecot-openssl.cnf |
| 0 | 36 #ssl_cert_file = /etc/ssl/certs/imapd.pem |
| 37 #ssl_key_file = /etc/ssl/private/imapd.pem | |
| 38 | |
|
615
0d852af6842e
Master process generates DH/RSA parameters now and stores them into file
Timo Sirainen <tss@iki.fi>
parents:
614
diff
changeset
|
39 # 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
|
40 # 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
|
41 #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
|
42 |
|
0d852af6842e
Master process generates DH/RSA parameters now and stores them into file
Timo Sirainen <tss@iki.fi>
parents:
614
diff
changeset
|
43 # 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
|
44 # 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
|
45 # entirely. |
|
0d852af6842e
Master process generates DH/RSA parameters now and stores them into file
Timo Sirainen <tss@iki.fi>
parents:
614
diff
changeset
|
46 #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
|
47 |
| 0 | 48 # Disable LOGIN command and all other plaintext authentications unless |
| 49 # SSL/TLS is used (LOGINDISABLED capability) | |
| 50 #disable_plaintext_auth = no | |
| 51 | |
|
35
b420373f88f6
Added log_path and log_timestamp settings to config file. Removed -l command
Timo Sirainen <tss@iki.fi>
parents:
27
diff
changeset
|
52 # 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
|
53 #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
|
54 |
|
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
|
55 # 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
|
56 #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
|
57 |
|
35
b420373f88f6
Added log_path and log_timestamp settings to config file. Removed -l command
Timo Sirainen <tss@iki.fi>
parents:
27
diff
changeset
|
58 # 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
|
59 # 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
|
60 #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
|
61 |
| 0 | 62 ## |
| 63 ## Login process | |
| 64 ## | |
| 65 | |
| 66 # Executable location | |
|
661
b88b5488bcfd
updated lib paths to libexec ones
Timo Sirainen <tss@iki.fi>
parents:
657
diff
changeset
|
67 #login_executable = /usr/libexec/dovecot/imap-login |
| 0 | 68 |
| 69 # User to use for imap-login process | |
| 70 #login_user = imapd | |
| 71 | |
|
722
0438621d25ff
Added virtual memory size limits to processes. Default values are pretty
Timo Sirainen <tss@iki.fi>
parents:
666
diff
changeset
|
72 # 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
|
73 # 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
|
74 #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
|
75 |
| 0 | 76 # Directory where imap-auth places authentication UNIX sockets which login |
| 77 # needs to be able to connect to. The sockets are created when running as | |
| 78 # root, so you don't need to give imap-auth any access for it. | |
| 79 #login_dir = /var/run/dovecot/login | |
| 80 | |
| 435 | 81 # chroot imap-login process to the login_dir. Only reason not to do this |
| 0 | 82 # is if you wish to run the whole imapd without roots. |
| 83 #login_chroot = yes | |
| 84 | |
|
613
1906116a62ce
Finally support for handling each login connection in it's own process.
Timo Sirainen <tss@iki.fi>
parents:
600
diff
changeset
|
85 # 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
|
86 # 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
|
87 # 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
|
88 # 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
|
89 #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
|
90 |
|
1906116a62ce
Finally support for handling each login connection in it's own process.
Timo Sirainen <tss@iki.fi>
parents:
600
diff
changeset
|
91 # 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
|
92 # 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
|
93 #login_processes_count = 3 |
| 0 | 94 |
|
614
e60620644af3
login_process_per_connection = yes scales now better when multiple users are
Timo Sirainen <tss@iki.fi>
parents:
613
diff
changeset
|
95 # 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
|
96 # 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
|
97 # 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
|
98 # 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
|
99 # 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
|
100 # 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
|
101 #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
|
102 |
| 0 | 103 # 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
|
104 # 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
|
105 # 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
|
106 # logging in actually login_processes_count * max_logging_users. |
| 0 | 107 #max_logging_users = 256 |
| 108 | |
| 109 ## | |
| 110 ## IMAP process | |
| 111 ## | |
| 112 | |
| 113 # Executable location | |
|
661
b88b5488bcfd
updated lib paths to libexec ones
Timo Sirainen <tss@iki.fi>
parents:
657
diff
changeset
|
114 #imap_executable = /usr/libexec/dovecot/imap |
| 0 | 115 |
|
722
0438621d25ff
Added virtual memory size limits to processes. Default values are pretty
Timo Sirainen <tss@iki.fi>
parents:
666
diff
changeset
|
116 # 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
|
117 # 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
|
118 #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
|
119 |
| 0 | 120 # Maximum number of running imap processes. When this limit is reached, |
| 121 # new users aren't allowed to log in. | |
| 122 #max_imap_processes = 1024 | |
| 123 | |
|
596
ab3590c3a7d9
Added verbose_proctitle setting: Show more verbose process titles (in ps).
Timo Sirainen <tss@iki.fi>
parents:
519
diff
changeset
|
124 # 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
|
125 # 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
|
126 # (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
|
127 #verbose_proctitle = no |
|
ab3590c3a7d9
Added verbose_proctitle setting: Show more verbose process titles (in ps).
Timo Sirainen <tss@iki.fi>
parents:
519
diff
changeset
|
128 |
| 0 | 129 # Valid UID/GID ranges for imap users, defaults to 500 and above. |
| 130 # Note that denying root logins is hardcoded to imap-master binary and | |
| 131 # can't be done even if first_valid_uid is set to 0. | |
| 132 #first_valid_uid = 500 | |
| 133 #last_valid_uid = 0 | |
| 134 | |
| 135 #first_valid_gid = 1 | |
| 136 #last_valid_gid = 0 | |
| 137 | |
| 138 # ':' separated list of directories under which chrooting is allowed for imap | |
| 139 # processes (ie. /var/mail will allow chrooting to /var/mail/foo/bar too). | |
| 140 # WARNING: Never add directories here which local users can modify, that | |
| 141 # may lead to root exploit. Usually this should be done only if you don't | |
| 142 # allow shell access for users. | |
| 143 #valid_chroot_dirs = | |
| 144 | |
|
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
|
145 # 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
|
146 # 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
|
147 # 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
|
148 # |
|
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 # %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
|
150 # %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
|
151 # %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
|
152 # %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
|
153 # |
|
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 # 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
|
155 # 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
|
156 # 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
|
157 # |
|
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 # 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
|
159 # 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
|
160 # 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
|
161 # |
|
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
|
162 #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
|
163 |
|
462
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
164 # 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
|
165 # 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
|
166 # |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
167 # 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
|
168 # 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
|
169 # 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
|
170 # 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
|
171 # 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
|
172 # 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
|
173 # 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
|
174 # 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
|
175 # 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
|
176 # |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
177 # 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
|
178 # 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
|
179 # 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
|
180 # 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
|
181 # 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
|
182 # 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
|
183 # 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
|
184 # |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
185 # 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
|
186 # 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
|
187 # 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
|
188 |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
189 #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
|
190 |
|
600
3b44bc64afd4
mailbox_check_interval setting: Dovecot can notify client of new mail in
Timo Sirainen <tss@iki.fi>
parents:
596
diff
changeset
|
191 # 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
|
192 # 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
|
193 # 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
|
194 # 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
|
195 # 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
|
196 #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
|
197 |
|
462
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
198 # 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
|
199 # 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
|
200 # needed. |
|
67d22b7b0918
Added mail_cache_fields and mail_never_cache_fields settings, plus settings
Timo Sirainen <tss@iki.fi>
parents:
435
diff
changeset
|
201 #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
|
202 |
|
472
2fa0bfb65268
Added setting mail_save_crlf. Few other settings cleanups.
Timo Sirainen <tss@iki.fi>
parents:
462
diff
changeset
|
203 # 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
|
204 # 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
|
205 # 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
|
206 #mail_save_crlf = no |
|
2fa0bfb65268
Added setting mail_save_crlf. Few other settings cleanups.
Timo Sirainen <tss@iki.fi>
parents:
462
diff
changeset
|
207 |
|
644
415498fa78d6
mail_read_mmaped: Use mmap() instead of read() to read mail files. read()
Timo Sirainen <tss@iki.fi>
parents:
643
diff
changeset
|
208 # 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
|
209 # 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
|
210 #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
|
211 |
| 0 | 212 # Copy mail to another folders using hard links. This is much faster than |
| 213 # actually copying the file. Only problem with it is that if either of the | |
| 214 # mails are modified directly both will change. This isn't a problem with | |
| 215 # IMAP however since it offers no way to modify the existing mails. Also | |
| 216 # at least mutt modifies mails by deleting the old one and inserting a new | |
| 217 # modified mail. So if performance matters at all you should turn this on. | |
| 218 #maildir_copy_with_hardlinks = no | |
| 219 | |
| 220 # Check if mails' content has been changed by external programs. This slows | |
|
882
38b3bc6ddcc4
Changed maildir_check_content_changes = yes now to treat the message as new
Timo Sirainen <tss@iki.fi>
parents:
872
diff
changeset
|
221 # down things as extra stat() needs to be called for each file. If changes are |
|
38b3bc6ddcc4
Changed maildir_check_content_changes = yes now to treat the message as new
Timo Sirainen <tss@iki.fi>
parents:
872
diff
changeset
|
222 # noticed, the message is treated as a new message, since IMAP protocol |
|
38b3bc6ddcc4
Changed maildir_check_content_changes = yes now to treat the message as new
Timo Sirainen <tss@iki.fi>
parents:
872
diff
changeset
|
223 # specifies that existing message are immutable. |
| 0 | 224 #maildir_check_content_changes = no |
| 225 | |
|
643
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
226 # 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
|
227 # 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
|
228 # 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
|
229 # 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
|
230 # created first. |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
231 #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
|
232 |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
233 # 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
|
234 # 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
|
235 # 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
|
236 # 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
|
237 #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
|
238 |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
239 # 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
|
240 #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
|
241 |
|
da34bdd4e0c6
Added mbox lock settings to config file. Support timeouting fcntl() and
Timo Sirainen <tss@iki.fi>
parents:
615
diff
changeset
|
242 # 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
|
243 # 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
|
244 #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
|
245 |
|
101
edc37d046b08
Added overwrite_incompatible_index setting. Also we now try to use only
Timo Sirainen <tss@iki.fi>
parents:
35
diff
changeset
|
246 # 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
|
247 # 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
|
248 # 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
|
249 # 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
|
250 #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
|
251 |
| 0 | 252 # umask to use for mail files and directories |
| 253 #umask = 0077 | |
| 254 | |
| 255 ## | |
| 256 ## Authentication processes | |
| 257 ## | |
| 258 | |
| 259 # You can have multiple processes; each time "auth = xx" is seen, a new | |
| 260 # process definition is started. The point of multiple processes is to be | |
| 261 # able to set stricter permissions to others. For example, plain/PAM | |
| 262 # authentication requires roots, but if you also use digest-md5 authentication | |
| 263 # for some users, you can authenticate them without any privileges in a | |
| 264 # separate auth process. Just remember that only one auth process is asked | |
| 265 # for the password, so you can't have different passwords with different | |
| 266 # processes (unless they have different auth methods, and you're ok with | |
| 267 # having different password for each method). | |
| 268 | |
| 269 # Authentication process name. | |
| 270 auth = default | |
| 271 | |
| 284 | 272 # Authentication methods this process allows separated with a space. |
| 273 # Currently supported: plain digest-md5 | |
| 0 | 274 auth_methods = plain |
| 275 | |
| 276 # Space separated list of realms with authentication methods that need them. | |
| 277 # This is usually empty or the host name of the server (eg. | |
| 278 # mail.mycompany.com). | |
| 279 # - plain auth checks the password from all realms specified in here | |
| 280 # - digest-md5 must have the password added for each realm separately, and | |
| 281 # many clients simply use the first realm listed here. so if you really | |
| 282 # need to add more realms, add them to end of the list. | |
| 283 #auth_realms = | |
| 284 | |
| 285 # Where the user information and passwords are stored into: | |
| 286 # passwd: /etc/passwd or similiar, using getpwnam() | |
| 287 # shadow: /etc/shadow or similiar, using getspnam() | |
| 288 # pam: PAM authentication | |
| 289 # passwd-file /etc/passwd.imap: /etc/passwd-like file. Supports digest-md5 | |
| 290 # style passwords | |
|
280
fa2d1a1d025e
vpopmail authentication. compiles, not tested if it really works.
Timo Sirainen <tss@iki.fi>
parents:
101
diff
changeset
|
291 # vpopmail: vpopmail authentication |
| 27 | 292 auth_userinfo = pam |
| 0 | 293 |
| 294 # Executable location | |
|
661
b88b5488bcfd
updated lib paths to libexec ones
Timo Sirainen <tss@iki.fi>
parents:
657
diff
changeset
|
295 #auth_executable = /usr/libexec/dovecot/imap-auth |
| 0 | 296 |
|
722
0438621d25ff
Added virtual memory size limits to processes. Default values are pretty
Timo Sirainen <tss@iki.fi>
parents:
666
diff
changeset
|
297 # 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
|
298 #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
|
299 |
| 0 | 300 # User to use for the process. Only shadow and pam authentication requires |
| 301 # roots, so use something else if possible. | |
| 302 auth_user = root | |
| 303 | |
| 435 | 304 # Directory where to chroot the process. Most authentication backends don't |
| 305 # work if this is set, and there's no point chrooting if auth_user is root. | |
| 0 | 306 #auth_chroot = |
| 307 | |
| 308 # Number of authentication processes to create | |
| 309 #auth_count = 1 | |
| 310 | |
| 311 | |
| 312 # digest-md5 authentication process. It requires special MD5 passwords which | |
| 313 # /etc/shadow and PAM doesn't support, so we never need roots to handle it. | |
| 314 # Note that the passwd-file is opened before chrooting and dropping root | |
| 315 # privileges, so it may be 0600-root owned file. | |
| 316 | |
| 317 #auth = digest_md5 | |
| 318 #auth_methods = digest-md5 | |
| 319 #auth_realms = | |
| 320 #auth_userinfo = passwd-file /etc/passwd.imap | |
| 321 #auth_user = imapauth | |
| 322 #auth_chroot = /var/run/dovecot/auth | |
| 323 | |
| 324 # if you plan to use only passwd-file, you don't need the two auth processes, | |
| 325 # simply set "auth_methods = plain digest-md5" |