1
Author: Jaldhar H. Vyas <jaldhar@debian.org>
2
Description: Small changes to dovecot-example.conf
3
Last-Update: 2009-07-31
5
Index: dovecot-1.2.9/dovecot-example.conf
6
===================================================================
7
--- dovecot-1.2.9.orig/dovecot-example.conf
8
+++ dovecot-1.2.9/dovecot-example.conf
10
# --sysconfdir=/etc --localstatedir=/var --with-ssldir=/etc/ssl
12
# Base directory where to store runtime data.
13
-#base_dir = /var/run/dovecot/
14
+#base_dir = /var/run/dovecot
16
# Protocols we want to be serving: imap imaps pop3 pop3s managesieve
17
# If you only want to use dovecot-auth, you can set this to "none".
18
#protocols = imap imaps
21
# A space separated list of IP or host addresses where to listen in for
22
# connections. "*" listens in all IPv4 interfaces. "[::]" listens in all IPv6
24
# Prefix for each line written to log file. % codes are in strftime(3)
26
#log_timestamp = "%b %d %H:%M:%S "
27
+log_timestamp = "%Y-%m-%d %H:%M:%S "
29
# Syslog facility to use if you're logging to syslog. Usually if you don't
30
# want to use "mail", you'll use local0..local7. Also other standard
32
# setting if not specified.
35
-# SSL/TLS support: yes, no, required. <doc/wiki/SSL.txt>
36
+# SSL/TLS support: yes, no, required. </usr/share/doc/dovecot-common/wiki/SSL.txt>
39
# PEM encoded X.509 SSL/TLS certificate and private key. They're opened before
40
# dropping root privileges, so keep the key file unreadable by anyone but
41
-# root. Included doc/mkcert.sh can be used to easily generate self-signed
42
-# certificate, just make sure to update the domains in dovecot-openssl.cnf
44
#ssl_cert_file = /etc/ssl/certs/dovecot.pem
45
#ssl_key_file = /etc/ssl/private/dovecot.pem
51
-# <doc/wiki/LoginProcess.txt>
52
+# </usr/share/doc/dovecot-common/wiki/LoginProcess.txt>
54
# Directory where authentication process places authentication UNIX sockets
55
# which login needs to be able to connect to. The sockets are created when
57
#login_dir = /var/run/dovecot/login
59
# chroot login process to the login_dir. Only reason not to do this is if you
60
-# wish to run the whole Dovecot without roots. <doc/wiki/Rootless.txt>
61
+# wish to run the whole Dovecot without roots. </usr/share/doc/dovecot-common/wiki/Rootless.txt>
64
# User to use for the login process. Create a completely new user for this,
65
# and don't use it anywhere else. The user must also belong to a group where
66
# only it has access, it's used to control access for authentication process.
67
-# Note that this user is NOT used to access mails. <doc/wiki/UserIds.txt>
68
+# Note that this user is NOT used to access mails. </usr/share/doc/dovecot-common/wiki/UserIds.txt>
71
# Set max. process size in megabytes. If you don't use
73
# %d - domain part in user@domain, empty if there's no domain
76
-# See <doc/wiki/Variables.txt> for full list. Some examples:
77
+# See </usr/share/doc/dovecot-common/wiki/Variables.txt> for full list.
80
# mail_location = maildir:~/Maildir
81
# mail_location = mbox:~/mail:INBOX=/var/mail/%u
82
# mail_location = mbox:/var/mail/%d/%1n/%n:INDEX=/var/indexes/%d/%1n/%n
84
-# <doc/wiki/MailLocation.txt>
85
+# </usr/share/doc/dovecot-common/wiki/MailLocation.txt>
91
# System user and group used to access mails. If you use multiple, userdb
92
# can override these by returning uid or gid fields. You can use either numbers
93
-# or names. <doc/wiki/UserIds.txt>
94
+# or names. </usr/share/doc/dovecot-common/wiki/UserIds.txt>
99
# used only with INBOX when either its initial creation or dotlocking fails.
100
# Typically this is set to "mail" to give access to /var/mail.
101
#mail_privileged_group =
102
+mail_privileged_group = mail
104
# Grant access to these supplementary groups for mail processes. Typically
105
# these are used to set up access to shared mailboxes. Note that it may be
107
# isn't finding your mails.
110
-# Log prefix for mail processes. See <doc/wiki/Variables.txt> for list of
111
-# possible variables you can use.
112
+# Log prefix for mail processes. See </usr/share/doc/dovecot-common/wiki/Variables.txt>
113
+# for list of possible variables you can use.
114
#mail_log_prefix = "%Us(%u): "
116
# Max. number of lines a mail process is allowed to log per second before it's
118
# settings. If this setting is empty, "/./" in home dirs are ignored.
119
# WARNING: Never add directories here which local users can modify, that
120
# may lead to root exploit. Usually this should be done only if you don't
121
-# allow shell access for users. <doc/wiki/Chrooting.txt>
122
+# allow shell access for users. </usr/share/doc/dovecot-common/wiki/Chrooting.txt>
125
# Default chroot directory for mail processes. This can be overridden for
127
# (eg. /home/./user chroots into /home). Note that usually there is no real
128
# need to do chrooting, Dovecot doesn't allow users to access files outside
129
# their mail directory anyway. If your home directories are prefixed with
130
-# the chroot directory, append "/." to mail_chroot. <doc/wiki/Chrooting.txt>
131
+# the chroot directory, append "/." to mail_chroot. </usr/share/doc/dovecot-common/wiki/Chrooting.txt>
135
@@ -541,20 +544,20 @@
138
# Login executable location.
139
- #login_executable = /usr/libexec/dovecot/imap-login
140
+ #login_executable = /usr/lib/dovecot/imap-login
142
# IMAP executable location. Changing this allows you to execute other
143
# binaries before the imap process is executed.
145
# This would write rawlogs into user's ~/dovecot.rawlog/, if it exists:
146
- # mail_executable = /usr/libexec/dovecot/rawlog /usr/libexec/dovecot/imap
147
- # <doc/wiki/Debugging/Rawlog.txt>
148
+ # mail_executable = /usr/lib/dovecot/rawlog /usr/lib/dovecot/imap
149
+ # </usr/doc/dovecot-common/wiki/Debugging.Rawlog.txt>
151
# This would attach gdb into the imap process and write backtraces into
152
# /tmp/gdbhelper.* files:
153
- # mail_executable = /usr/libexec/dovecot/gdbhelper /usr/libexec/dovecot/imap
154
+ # mail_executable = /usr/lib/dovecot/gdbhelper /usr/lib/dovecot/imap
156
- #mail_executable = /usr/libexec/dovecot/imap
157
+ #mail_executable = /usr/lib/dovecot/imap
159
# Maximum IMAP command line length in bytes. Some clients generate very long
160
# command lines with huge mailboxes, so you may need to raise this if you get
162
# Support for dynamically loadable plugins. mail_plugins is a space separated
163
# list of plugins to load.
165
- #mail_plugin_dir = /usr/lib/dovecot/imap
166
+ #mail_plugin_dir = /usr/lib/dovecot/modules/imap
168
# IMAP logout format string:
169
# %i - total number of bytes read from client
170
@@ -618,11 +621,11 @@
173
# Login executable location.
174
- #login_executable = /usr/libexec/dovecot/pop3-login
175
+ #login_executable = /usr/lib/dovecot/pop3-login
177
# POP3 executable location. See IMAP's mail_executable above for examples
178
# how this could be changed.
179
- #mail_executable = /usr/libexec/dovecot/pop3
180
+ #mail_executable = /usr/lib/dovecot/pop3
182
# Don't try to set mails non-recent or seen with POP3 sessions. This is
183
# mostly intended to reduce disk I/O. With maildir it doesn't move files
186
# POP3 UIDL (unique mail identifier) format to use. You can use following
187
# variables, along with the variable modifiers described in
188
- # <doc/wiki/Variables.txt> (e.g. %Uf for the filename in uppercase)
189
+ # </usr/share/doc/dovecot-common/wiki/Variables.txt> (e.g. %Uf for the
190
+ # filename in uppercase)
192
# %v - Mailbox's IMAP UIDVALIDITY
193
# %u - Mail's IMAP UID
195
# Dovecot's default, so if you're building a new server it would be a good
196
# idea to change this. %08Xu%08Xv should be pretty fail-safe.
198
- #pop3_uidl_format = %08Xu%08Xv
199
+ pop3_uidl_format = %08Xu%08Xv
201
# Permanently save UIDLs sent to POP3 clients, so pop3_uidl_format changes
202
# won't change those UIDLs. Currently this works only with Maildir.
204
# Support for dynamically loadable plugins. mail_plugins is a space separated
205
# list of plugins to load.
207
- #mail_plugin_dir = /usr/lib/dovecot/pop3
208
+ #mail_plugin_dir = /usr/lib/dovecot/modules/pop3
210
# Workarounds for various client bugs:
212
@@ -705,11 +709,11 @@
214
protocol managesieve {
215
# Login executable location.
216
- #login_executable = /usr/libexec/dovecot/managesieve-login
217
+ #login_executable = /usr/lib/dovecot/managesieve-login
219
# ManageSieve executable location. See IMAP's mail_executable above for
220
# examples how this could be changed.
221
- #mail_executable = /usr/libexec/dovecot/managesieve
222
+ #mail_executable = /usr/lib/dovecot/managesieve
224
# Maximum ManageSieve command line length in bytes. This setting is
225
# directly borrowed from IMAP. But, since long command lines are very
227
## LDA specific settings
232
# Address to use when sending rejection mails.
233
- postmaster_address = postmaster@example.com
234
+ #postmaster_address = postmaster@example.com
236
# Hostname to use in various parts of sent mails, eg. in Message-Id.
237
# Default is the system's real hostname.
239
# Support for dynamically loadable plugins. mail_plugins is a space separated
240
# list of plugins to load.
242
- #mail_plugin_dir = /usr/lib/dovecot/lda
243
+ #mail_plugin_dir = /usr/lib/dovecot/modules/lda
245
# If user is over quota, return with temporary failure instead of
247
@@ -772,14 +776,14 @@
249
# UNIX socket path to master authentication server to find users.
250
#auth_socket_path = /var/run/dovecot/auth-master
255
## Authentication processes
258
# Executable location
259
-#auth_executable = /usr/libexec/dovecot/dovecot-auth
260
+#auth_executable = /usr/lib/dovecot/dovecot-auth
262
# Set max. process size in megabytes.
263
#auth_process_size = 256
267
# Do NTLM and GSS-SPNEGO authentication using Samba's winbind daemon and
268
-# ntlm_auth helper. <doc/wiki/Authentication/Mechanisms/Winbind.txt>
270
+# </usr/share/doc/dovecot-common/wiki/Authentication.Mechanisms.Winbind.txt>
271
#auth_use_winbind = no
273
# Path for Samba's ntlm_auth helper binary.
274
@@ -883,13 +888,13 @@
275
# allow both system users (/etc/passwd) and virtual users to login without
276
# duplicating the system users into virtual database.
278
- # <doc/wiki/PasswordDatabase.txt>
279
+ # </usr/share/doc/dovecot-common/wiki/PasswordDatabase.txt>
281
# By adding master=yes setting inside a passdb you make the passdb a list
282
# of "master users", who can log in as anyone else. Unless you're using PAM,
283
# you probably still want the destination user to be looked up from passdb
284
# that it really exists. This can be done by adding pass=yes setting to the
285
- # master passdb. <doc/wiki/Authentication.MasterUsers.txt>
286
+ # master passdb. </usr/share/doc/dovecot-common/wiki/Authentication.MasterUsers.txt>
288
# Users can be temporarily disabled by adding a passdb with deny=yes.
289
# If the user is found from that database, authentication will fail.
292
#passdb passwd-file {
293
# File contains a list of usernames, one per line
294
- #args = /etc/dovecot.deny
295
+ #args = /etc/dovecot/dovecot.deny
300
# so it can't be used as userdb. If you don't want to use a separate user
301
# database (passwd usually), you can use static userdb.
302
# REMEMBER: You'll need /etc/pam.d/dovecot file created for PAM
303
- # authentication to actually work. <doc/wiki/PasswordDatabase.PAM.txt>
304
+ # authentication to actually work. </usr/share/doc/dovecot-common/wiki/PasswordDatabase.PAM.txt>
306
# [session=yes] [setcred=yes] [failure_show_msg=yes] [max_requests=<n>]
307
# [cache_key=<key>] [<service name>]
309
# because PAM modules can do all kinds of checks besides checking password,
310
# such as checking IP address. Dovecot can't know about these checks
311
# without some help. cache_key is simply a list of variables (see
312
- # doc/wiki/Variables.txt) which must match for the cached data to be used.
313
+ # /usr/share/doc/dovecot-common/wiki/Variables.txt) which must match
314
+ # for the cached data to be used.
315
# Here are some examples:
316
# %u - Username must match. Probably sufficient for most uses.
317
# %u%r - Username and remote IP address must match.
320
# System users (NSS, /etc/passwd, or similiar)
321
# In many systems nowadays this uses Name Service Switch, which is
322
- # configured in /etc/nsswitch.conf. <doc/wiki/AuthDatabase.Passwd.txt>
323
+ # configured in /etc/nsswitch.conf. </usr/share/doc/dovecot-common/wiki/AuthDatabase.Passwd.txt>
325
# [blocking=yes] - See userdb passwd for explanation
327
@@ -953,21 +959,21 @@
329
# Shadow passwords for system users (NSS, /etc/shadow or similiar).
330
# Deprecated by PAM nowadays.
331
- # <doc/wiki/PasswordDatabase.Shadow.txt>
332
+ # </usr/share/doc/dovecot-common/wiki/PasswordDatabase.Shadow.txt>
334
# [blocking=yes] - See userdb passwd for explanation
338
# PAM-like authentication for OpenBSD.
339
- # <doc/wiki/PasswordDatabase.BSDAuth.txt>
340
+ # </usr/share/doc/dovecot-common/wiki/PasswordDatabase.BSDAuth.txt>
342
# [cache_key=<key>] - See cache_key in PAM for explanation.
346
# passwd-like file with specified location
347
- # <doc/wiki/AuthDatabase.PasswdFile.txt>
348
+ # </usr/share/doc/dovecot-common/wiki/AuthDatabase.PasswdFile.txt>
349
#passdb passwd-file {
350
# [scheme=<default password scheme>] [username_format=<format>]
351
# <Path for passwd-file>
352
@@ -976,25 +982,25 @@
354
# checkpassword executable authentication
355
# NOTE: You will probably want to use "userdb prefetch" with this.
356
- # <doc/wiki/AuthDatabase.CheckPassword.txt>
357
+ # </usr/share/doc/dovecot-common/wiki/AuthDatabase.CheckPassword.txt>
358
#passdb checkpassword {
359
# Path for checkpassword binary
363
- # SQL database <doc/wiki/AuthDatabase.SQL.txt>
364
+ # SQL database </usr/share/doc/dovecot-common/wiki/AuthDatabase.SQL.txt>
366
- # Path for SQL configuration file, see doc/dovecot-sql-example.conf
368
+ # Path for SQL configuration file
369
+ #args = /etc/dovecot/dovecot-sql.conf
372
- # LDAP database <doc/wiki/AuthDatabase.LDAP.txt>
373
+ # LDAP database </usr/share/doc/dovecot-common/wiki/AuthDatabase.LDAP.txt>
375
- # Path for LDAP configuration file, see doc/dovecot-ldap-example.conf
377
+ # Path for LDAP configuration file
378
+ #args = /etc/dovecot/dovecot-ldap.conf
381
- # vpopmail authentication <doc/wiki/AuthDatabase.VPopMail.txt>
382
+ # vpopmail authentication </usr/share/doc/dovecot-common/wiki/AuthDatabase.VPopMail.txt>
384
# [cache_key=<key>] - See cache_key in PAM for explanation.
385
# [quota_template=<template>] - %q expands to Maildir++ quota
386
@@ -1006,20 +1012,20 @@
387
# User database specifies where mails are located and what user/group IDs
388
# own them. For single-UID configuration use "static".
390
- # <doc/wiki/UserDatabase.txt>
391
+ # </usr/share/doc/dovecot-common/wiki/UserDatabase.txt>
394
# "prefetch" user database means that the passdb already provided the
395
# needed information and there's no need to do a separate userdb lookup.
396
# This can be made to work with SQL and LDAP databases, see their example
397
# configuration files for more information how to do it.
398
- # <doc/wiki/UserDatabase.Prefetch.txt>
399
+ # </usr/share/doc/dovecot-common/wiki/UserDatabase.Prefetch.txt>
403
# System users (NSS, /etc/passwd, or similiar). In many systems nowadays this
404
# uses Name Service Switch, which is configured in /etc/nsswitch.conf.
405
- # <doc/wiki/AuthDatabase.Passwd.txt>
406
+ # </usr/share/doc/dovecot-common/wiki/AuthDatabase.Passwd.txt>
408
# [blocking=yes] - By default the lookups are done in the main dovecot-auth
409
# process. This setting causes the lookups to be done in auth worker
410
@@ -1030,20 +1036,20 @@
413
# passwd-like file with specified location
414
- # <doc/wiki/AuthDatabase.PasswdFile.txt>
415
+ # </usr/share/doc/dovecot-common/wiki/AuthDatabase.PasswdFile.txt>
416
#userdb passwd-file {
417
# [username_format=<format>] <Path for passwd-file>
421
# checkpassword executable user database lookup
422
- # <doc/wiki/AuthDatabase.CheckPassword.txt>
423
+ # </usr/share/doc/dovecot-common/wiki/AuthDatabase.CheckPassword.txt>
424
#userdb checkpassword {
425
# Path for checkpassword binary
429
- # static settings generated from template <doc/wiki/UserDatabase.Static.txt>
430
+ # static settings generated from template </usr/share/doc/dovecot-common/wiki/UserDatabase.Static.txt>
432
# Template for the fields. Can return anything a userdb could normally
433
# return. For example:
434
@@ -1060,19 +1066,19 @@
438
- # SQL database <doc/wiki/AuthDatabase.SQL.txt>
439
+ # SQL database </usr/share/doc/dovecot-common/wiki/AuthDatabase.SQL.txt>
441
- # Path for SQL configuration file, see doc/dovecot-sql-example.conf
443
+ # Path for SQL configuration file
444
+ #args = /etc/dovecot/dovecot-sql.conf
447
- # LDAP database <doc/wiki/AuthDatabase.LDAP.txt>
448
+ # LDAP database </usr/share/doc/dovecot-common/wiki/AuthDatabase.LDAP.txt>
450
- # Path for LDAP configuration file, see doc/dovecot-ldap-example.conf
452
+ # Path for LDAP configuration file
453
+ #args = /etc/dovecot/dovecot-ldap.conf
456
- # vpopmail <doc/wiki/AuthDatabase.VPopMail.txt>
457
+ # vpopmail </usr/share/doc/dovecot-common/wiki/AuthDatabase.VPopMail.txt>
461
@@ -1146,7 +1152,7 @@
462
# format "proxy::<name>".
465
- #quota = mysql:/etc/dovecot-dict-quota.conf
466
+ #quota = mysql:/etc/dovecot/dovecot-dict-quota.conf
467
#expire = db:/var/lib/dovecot/expire.db
470
@@ -1198,7 +1204,7 @@
471
# one file for each mailbox, eg. INBOX or sub.mailbox. cache_secs parameter
472
# specifies how many seconds to wait between stat()ing dovecot-acl file
473
# to see if it changed.
474
- #acl = vfile:/etc/dovecot-acls:cache_secs=300
475
+ #acl = vfile:/etc/dovecot/dovecot-acls:cache_secs=300
477
# To let users LIST mailboxes shared by other users, Dovecot needs a
478
# shared mailbox dictionary. For example:
479
@@ -1221,14 +1227,14 @@
480
# until the message can be saved within quota limits. The configuration file
481
# is a text file where each line is in format: <priority> <mailbox name>
482
# Mails are first deleted in lowest -> highest priority number order
483
- #trash = /etc/dovecot-trash.conf
484
+ #trash = /etc/dovecot/dovecot-trash.conf
486
# Expire plugin. Mails are expunged from mailboxes after being there the
487
# configurable time. The first expiration date for each mailbox is stored in
488
# a dictionary so it can be quickly determined which mailboxes contain
489
# expired mails. The actual expunging is done in a nightly cronjob, which
491
- # dovecot --exec-mail ext /usr/libexec/dovecot/expire-tool
492
+ # dovecot --exec-mail ext /usr/lib/dovecot/expire-tool
493
#expire = Trash 7 Spam 30
494
#expire_dict = proxy::expire