← Back to branch summary

~ubuntu-dev/ubuntu/lucid/dovecot/lucid-201002101901

« back to all changes in this revision

Viewing changes to dovecot-example.conf

  • Committer: Chuck Short
  • Date: 2010-01-21 20:21:25 UTC
  • mfrom: (4.1.11 squeeze)
  • Revision ID: zulcss@ubuntu.com-20100121202125-pme73o491kfwj5nc
http://bugs.debian.org/493803
http://bugs.debian.org/523810
http://bugs.debian.org/545582
http://bugs.debian.org/549944
http://bugs.debian.org/554306
http://bugs.debian.org/554710
http://bugs.debian.org/557601
http://bugs.debian.org/558040
https://launchpad.net/bugs/164837
https://launchpad.net/bugs/254721
https://launchpad.net/bugs/329878
* Merge from debian testing, remaining changes:
  + Add new binary pkg dovecot-postfix that integrates postfix and dovecot
    automatically: (LP: #164837)
  + debian/control:
    - add new binary with short description
    - set Architecture all for dovecot-postfix (LP: #329878)
  + debian/dovecot-postfix.postinst:
    - create initial certificate symlinks to snakeoil.
    - set up postfix with postconf to:
      - use Maildir/ as the default mailbox.
      - use dovecot as the sasl authentication server.
      - use dovecot LDA (deliver).
      - use tls for smtp{d} services.
    - fix certificates paths in postfix' main.cf
    - add reject_unauth_destination to postfix' recipient restrictions
    - add reject_unknown_sender_domain to postfix' sender restriction
    - rename configuration name on remove, delete on purge
    - restart dovecot after linking certificates
    - handle use case when postfix is unconfigurated
  + debian/dovecot-postfix.dirs: create backup directory for postfix's config
    configuration
  + restart postfix and dovecot.
  + debian/dovecot-postfix.postrm:
    - remove all dovecot related configuration from postfix.
    - restart postfix and dovecot.
  + debian/dovecot-common.init:
    - check if /etc/dovecot/dovecot-postfix.conf exists and use it
      as the configuration file if so.
  + debian/patches/warning-ubuntu-postfix.dpatch
    - add warning about dovecot-postfix.conf in dovecot default
      configuration file
  + debian/patches/dovecot-postfix.conf.diff:
    - Ubuntu server custom changes to the default dovecot configuration for
      better interfation with postfix.
    - enable sieve plugin.
    - Ubuntu server custom changes to the default dovecot configuration for
      better integration with postfix:
      - enable imap, pop3, imaps, pop3s and managesieve by default.
      - enable dovecot LDA (deliver).
      - enable SASL auth socket in postfix private directory
   + debian/rules:
     - copy, patch and install dovecot-postfix.conf in /etc/dovecot/.
     - build architecure independent packages too
   + Use Snakeoil SSL certificates by default.
     - debian/control: Depend on ssl-cert.
     - debian/patches/ssl-cert-snakeoil.dpatch: Change default SSL cert
       paths to snakeoil.
     - debian/dovecot-common.postinst: Relax grep for SSL_* a bit.
   + Add autopkgtest to debian/tests/*.
   + Fast TearDown: Update the lsb init header to not stop in level 6.
   + Add ufw integration:
     - Created debian/dovecot-common.ufw.profile.
     - debian/rules: install profile.
     - debian/control: suggest ufw.
   + debian/{control,rules}: enable PIE hardening.
   + dovecot-imapd, dovecot-pop3: Replaces dovecot-common (<< 1:1.1). (LP: #254721)
   + debian/control: Update Vcs-* headers.
   + Add SMTP-AUTH support for Outlook (login auth mechanism)
* New upstream release.
* debian/patches/gold-fix.patch: Removed. Fixed upstream.
* Moved libexec to lib corrections in dovecot-managesieve.patch and
  dovecot-managesieve-dist.patch to dovecot-example.patch
* debian/patches/dovecot-mboxlocking.patch: Regenerated to avoid FTBFS
  when quilt isn't installed.
* debian/patches/quota-mountpoint.patch: Removed. Not needed anymore.
* debian/patches/dovecot-quota.patch: Removed. Quotas aren't properly
  enabled unless mail_plugins = quota imap_quota.
* debian/patches/gold-fix.patch: Fixed configure script to build even
  with binutils-gold or --no-add-needed linker flag (Closes: #554306)
* debian/dovecot-common.init: fixed LSB headers. Thanks to Pascal Volk.
  (Closes: #558040)
* debian/changelog: added CVE references to previous changelog entry.
* debian/rules: checked up the build system. It's not fragile anymore.
  (Closes: 493803)
* debian/dovecot-common.postinst: Now invoking dpkg-reconfigure
  on dovecot-common is enough to generate new certificates
  if the previous ones were removed. (Closes: #545582)
* debian/rules: No longer install convert-tool in /usr/bin.
  It isn't an user utility and it should stay in /usr/lib/dovecot
  like all other similar tool.
* New upstream release. (Closes: #557601)
* [SECURITY] Fixes local information disclosure and denial of service.
  (see: http://www.dovecot.org/list/dovecot-news/2009-November/000143.html
  and CVE-2009-3897)
* Added myself to uploaders.
* Switched to the new source format "3.0 (quilt)":
  - removed dpatch from build-depends
  - removed debian/README.source because now we use only standard
    dpkg features
  - regenerated all patches
* Prepared to switch to multi-origin source:
  - recreated dovecot-libsieve.patch and dovecot-managesieve-dist.patch
    starting from the upstream tarball
  - removed all autotools related build-depends and build-conflict
  - renamed dovecot-libsieve and dovecot-managesieve directories
    to libsieve and managesieve.
* debian/rules: Moved the configuration of libsieve and managesieve from
  the build phase to the configuration phase
* Added dovecot-dbg package  with debugging symbols.  Thanks Stephan Bosch.
  (Closes: #554710)
* Fixed some stray libexec'isms in the default configuration.
* New upstream release.
* debian/dovecot-common.init:
  - use $CONF when starting the daemon. (Closes: #549944)
  - always output start/stop messages. (Closes: #523810)

Show diffs side-by-side

added added

removed removed

Lines of Context:
dovecot-example.conf
17
17
# --sysconfdir=/etc --localstatedir=/var --with-ssldir=/etc/ssl
18
18
 
19
19
# Base directory where to store runtime data.
20
 
#base_dir = /var/run/dovecot/
 
20
#base_dir = /var/run/dovecot
21
21
 
22
 
# Protocols we want to be serving: imap imaps pop3 pop3s
 
22
# Protocols we want to be serving: imap imaps pop3 pop3s managesieve
23
23
# If you only want to use dovecot-auth, you can set this to "none".
24
24
#protocols = imap imaps
 
25
protocols = none
25
26
 
26
27
# A space separated list of IP or host addresses where to listen in for
27
28
# connections. "*" listens in all IPv4 interfaces. "[::]" listens in all IPv6
28
29
# interfaces. Use "*, [::]" for listening both IPv4 and IPv6.
29
30
#
30
31
# If you want to specify ports for each service, you will need to configure
31
 
# these settings inside the protocol imap/pop3 { ... } section, so you can
32
 
# specify different ports for IMAP/POP3. For example:
 
32
# these settings inside the protocol imap/pop3/managesieve { ... } section, 
 
33
# so you can specify different ports for IMAP/POP3/MANAGESIEVE. For example:
33
34
#   protocol imap {
34
35
#     listen = *:10143
35
36
#     ssl_listen = *:10943
39
40
#     listen = *:10100
40
41
#     ..
41
42
#   }
 
43
#   protocol managesieve {
 
44
#     listen = *:12000
 
45
#     ..
 
46
#   }
42
47
#listen = *
43
48
 
44
49
# Disable LOGIN command and all other plaintext authentications unless
70
75
# Prefix for each line written to log file. % codes are in strftime(3)
71
76
# format.
72
77
#log_timestamp = "%b %d %H:%M:%S "
 
78
log_timestamp = "%Y-%m-%d %H:%M:%S "
73
79
 
74
80
# Syslog facility to use if you're logging to syslog. Usually if you don't
75
81
# want to use "mail", you'll use local0..local7. Also other standard
85
91
# setting if not specified.
86
92
#ssl_listen =
87
93
 
88
 
# SSL/TLS support: yes, no, required. <doc/wiki/SSL.txt>
 
94
# SSL/TLS support: yes, no, required. </usr/share/doc/dovecot-common/wiki/SSL.txt>
89
95
#ssl = yes
90
96
 
91
97
# PEM encoded X.509 SSL/TLS certificate and private key. They're opened before
92
98
# dropping root privileges, so keep the key file unreadable by anyone but
93
 
# root. Included doc/mkcert.sh can be used to easily generate self-signed
94
 
# certificate, just make sure to update the domains in dovecot-openssl.cnf
 
99
# root.
95
100
#ssl_cert_file = /etc/ssl/certs/dovecot.pem
96
101
#ssl_key_file = /etc/ssl/private/dovecot.pem
97
102
 
130
135
## Login processes
131
136
##
132
137
 
133
 
# <doc/wiki/LoginProcess.txt>
 
138
# </usr/share/doc/dovecot-common/wiki/LoginProcess.txt>
134
139
 
135
140
# Directory where authentication process places authentication UNIX sockets
136
141
# which login needs to be able to connect to. The sockets are created when
139
144
#login_dir = /var/run/dovecot/login
140
145
 
141
146
# chroot login process to the login_dir. Only reason not to do this is if you
142
 
# wish to run the whole Dovecot without roots. <doc/wiki/Rootless.txt>
 
147
# wish to run the whole Dovecot without roots. </usr/share/doc/dovecot-common/wiki/Rootless.txt>
143
148
#login_chroot = yes
144
149
 
145
150
# User to use for the login process. Create a completely new user for this,
146
151
# and don't use it anywhere else. The user must also belong to a group where
147
152
# only it has access, it's used to control access for authentication process.
148
 
# Note that this user is NOT used to access mails. <doc/wiki/UserIds.txt>
 
153
# Note that this user is NOT used to access mails. </usr/share/doc/dovecot-common/wiki/UserIds.txt>
149
154
#login_user = dovecot
150
155
 
151
156
# Set max. process size in megabytes. If you don't use
213
218
#   %d - domain part in user@domain, empty if there's no domain
214
219
#   %h - home directory
215
220
#
216
 
# See <doc/wiki/Variables.txt> for full list. Some examples:
 
221
# See </usr/share/doc/dovecot-common/wiki/Variables.txt> for full list.
 
222
# Some examples:
217
223
#
218
224
#   mail_location = maildir:~/Maildir
219
225
#   mail_location = mbox:~/mail:INBOX=/var/mail/%u
220
226
#   mail_location = mbox:/var/mail/%d/%1n/%n:INDEX=/var/indexes/%d/%1n/%n
221
227
#
222
 
# <doc/wiki/MailLocation.txt>
 
228
# </usr/share/doc/dovecot-common/wiki/MailLocation.txt>
223
229
#
224
230
#mail_location = 
225
231
 
295
301
 
296
302
# System user and group used to access mails. If you use multiple, userdb
297
303
# can override these by returning uid or gid fields. You can use either numbers
298
 
# or names. <doc/wiki/UserIds.txt>
 
304
# or names. </usr/share/doc/dovecot-common/wiki/UserIds.txt>
299
305
#mail_uid =
300
306
#mail_gid =
301
307
 
303
309
# used only with INBOX when either its initial creation or dotlocking fails.
304
310
# Typically this is set to "mail" to give access to /var/mail.
305
311
#mail_privileged_group =
 
312
mail_privileged_group = mail
306
313
 
307
314
# Grant access to these supplementary groups for mail processes. Typically
308
315
# these are used to set up access to shared mailboxes. Note that it may be
325
332
# isn't finding your mails.
326
333
#mail_debug = no
327
334
 
328
 
# Log prefix for mail processes. See <doc/wiki/Variables.txt> for list of
329
 
# possible variables you can use.
 
335
# Log prefix for mail processes. See </usr/share/doc/dovecot-common/wiki/Variables.txt>
 
336
# for list of possible variables you can use.
330
337
#mail_log_prefix = "%Us(%u): "
331
338
 
332
339
# Max. number of lines a mail process is allowed to log per second before it's
403
410
# settings. If this setting is empty, "/./" in home dirs are ignored.
404
411
# WARNING: Never add directories here which local users can modify, that
405
412
# may lead to root exploit. Usually this should be done only if you don't
406
 
# allow shell access for users. <doc/wiki/Chrooting.txt>
 
413
# allow shell access for users. </usr/share/doc/dovecot-common/wiki/Chrooting.txt>
407
414
#valid_chroot_dirs = 
408
415
 
409
416
# Default chroot directory for mail processes. This can be overridden for
411
418
# (eg. /home/./user chroots into /home). Note that usually there is no real
412
419
# need to do chrooting, Dovecot doesn't allow users to access files outside
413
420
# their mail directory anyway. If your home directories are prefixed with
414
 
# the chroot directory, append "/." to mail_chroot. <doc/wiki/Chrooting.txt>
 
421
# the chroot directory, append "/." to mail_chroot. </usr/share/doc/dovecot-common/wiki/Chrooting.txt>
415
422
#mail_chroot = 
416
423
 
417
424
##
481
488
# in is important to avoid deadlocks if other MTAs/MUAs are using multiple
482
489
# locking methods as well. Some operating systems don't allow using some of
483
490
# them simultaneously.
 
491
#
 
492
# The Debian value for mbox_write_locks differs from upstream Dovecot. It is
 
493
# changed to be compliant with Debian Policy (section 11.6) for NFS safety.
 
494
#       Dovecot: mbox_write_locks = dotlock fcntl
 
495
#       Debian:  mbox_write_locks = fcntl dotlock
 
496
#
484
497
#mbox_read_locks = fcntl
485
 
#mbox_write_locks = dotlock fcntl
 
498
#mbox_write_locks = fcntl dotlock
486
499
 
487
500
# Maximum time in seconds to wait for lock (all of them) before aborting.
488
501
#mbox_lock_timeout = 300
537
550
 
538
551
protocol imap {
539
552
  # Login executable location.
540
 
  #login_executable = /usr/libexec/dovecot/imap-login
 
553
  #login_executable = /usr/lib/dovecot/imap-login
541
554
 
542
555
  # IMAP executable location. Changing this allows you to execute other
543
556
  # binaries before the imap process is executed.
544
557
  #
545
558
  # This would write rawlogs into user's ~/dovecot.rawlog/, if it exists:
546
 
  #   mail_executable = /usr/libexec/dovecot/rawlog /usr/libexec/dovecot/imap
547
 
  # <doc/wiki/Debugging/Rawlog.txt>
 
559
  #   mail_executable = /usr/lib/dovecot/rawlog /usr/lib/dovecot/imap
 
560
  # </usr/doc/dovecot-common/wiki/Debugging.Rawlog.txt>
548
561
  #
549
562
  # This would attach gdb into the imap process and write backtraces into
550
563
  # /tmp/gdbhelper.* files:
551
 
  #   mail_executable = /usr/libexec/dovecot/gdbhelper /usr/libexec/dovecot/imap
 
564
  #   mail_executable = /usr/lib/dovecot/gdbhelper /usr/lib/dovecot/imap
552
565
  #
553
 
  #mail_executable = /usr/libexec/dovecot/imap
 
566
  #mail_executable = /usr/lib/dovecot/imap
554
567
 
555
568
  # Maximum IMAP command line length in bytes. Some clients generate very long
556
569
  # command lines with huge mailboxes, so you may need to raise this if you get
564
577
  # Support for dynamically loadable plugins. mail_plugins is a space separated
565
578
  # list of plugins to load.
566
579
  #mail_plugins = 
567
 
  #mail_plugin_dir = /usr/lib/dovecot/imap
 
580
  #mail_plugin_dir = /usr/lib/dovecot/modules/imap
568
581
 
569
582
  # IMAP logout format string:
570
583
  #  %i - total number of bytes read from client
614
627
 
615
628
protocol pop3 {
616
629
  # Login executable location.
617
 
  #login_executable = /usr/libexec/dovecot/pop3-login
 
630
  #login_executable = /usr/lib/dovecot/pop3-login
618
631
 
619
632
  # POP3 executable location. See IMAP's mail_executable above for examples
620
633
  # how this could be changed.
621
 
  #mail_executable = /usr/libexec/dovecot/pop3
 
634
  #mail_executable = /usr/lib/dovecot/pop3
622
635
 
623
636
  # Don't try to set mails non-recent or seen with POP3 sessions. This is
624
637
  # mostly intended to reduce disk I/O. With maildir it doesn't move files
638
651
 
639
652
  # POP3 UIDL (unique mail identifier) format to use. You can use following
640
653
  # variables, along with the variable modifiers described in
641
 
  # <doc/wiki/Variables.txt> (e.g. %Uf for the filename in uppercase)
 
654
  # </usr/share/doc/dovecot-common/wiki/Variables.txt> (e.g. %Uf for the
 
655
  # filename in uppercase)
642
656
  #
643
657
  #  %v - Mailbox's IMAP UIDVALIDITY
644
658
  #  %u - Mail's IMAP UID
657
671
  # Dovecot's default, so if you're building a new server it would be a good
658
672
  # idea to change this. %08Xu%08Xv should be pretty fail-safe.
659
673
  #
660
 
  #pop3_uidl_format = %08Xu%08Xv
 
674
  pop3_uidl_format = %08Xu%08Xv
661
675
 
662
676
  # Permanently save UIDLs sent to POP3 clients, so pop3_uidl_format changes
663
677
  # won't change those UIDLs. Currently this works only with Maildir.
682
696
  # Support for dynamically loadable plugins. mail_plugins is a space separated
683
697
  # list of plugins to load.
684
698
  #mail_plugins = 
685
 
  #mail_plugin_dir = /usr/lib/dovecot/pop3
 
699
  #mail_plugin_dir = /usr/lib/dovecot/modules/pop3
686
700
 
687
701
  # Workarounds for various client bugs:
688
702
  #   outlook-no-nuls:
696
710
}
697
711
 
698
712
##
 
713
## ManageSieve specific settings
 
714
##
 
715
 
 
716
protocol managesieve {
 
717
  # Login executable location.
 
718
  #login_executable = /usr/lib/dovecot/managesieve-login
 
719
 
 
720
  # ManageSieve executable location. See IMAP's mail_executable above for 
 
721
  # examples how this could be changed.
 
722
  #mail_executable = /usr/lib/dovecot/managesieve
 
723
 
 
724
  # Maximum ManageSieve command line length in bytes. This setting is 
 
725
  # directly borrowed from IMAP. But, since long command lines are very
 
726
  # unlikely with ManageSieve, changing this will not be very useful.  
 
727
  #managesieve_max_line_length = 65536
 
728
 
 
729
  # ManageSieve logout format string:
 
730
  #  %i - total number of bytes read from client
 
731
  #  %o - total number of bytes sent to client
 
732
  #managesieve_logout_format = bytes=%i/%o
 
733
 
 
734
  # To fool ManageSieve clients that are focused on timesieved you can
 
735
  # specify the IMPLEMENTATION capability that the dovecot reports to clients 
 
736
  # (default: "dovecot").
 
737
  #managesieve_implementation_string = Cyrus timsieved v2.2.13
 
738
 
 
739
  # The ManageSieve service also uses the sieve and sieve_dir settings
 
740
  # of the Sieve plugin. These are configured in the plugin {} section of
 
741
  # this config file. 
 
742
}
 
743
 
 
744
##
699
745
## LDA specific settings
700
746
##
701
747
 
702
 
protocol lda {
 
748
#protocol lda {
703
749
  # Address to use when sending rejection mails.
704
 
  postmaster_address = postmaster@example.com
 
750
  #postmaster_address = postmaster@example.com
705
751
 
706
752
  # Hostname to use in various parts of sent mails, eg. in Message-Id.
707
753
  # Default is the system's real hostname.
710
756
  # Support for dynamically loadable plugins. mail_plugins is a space separated
711
757
  # list of plugins to load.
712
758
  #mail_plugins = 
713
 
  #mail_plugin_dir = /usr/lib/dovecot/lda
 
759
  #mail_plugin_dir = /usr/lib/dovecot/modules/lda
714
760
 
715
761
  # If user is over quota, return with temporary failure instead of
716
762
  # bouncing the mail.
736
782
 
737
783
  # UNIX socket path to master authentication server to find users.
738
784
  #auth_socket_path = /var/run/dovecot/auth-master
739
 
}
 
785
#}
740
786
 
741
787
##
742
788
## Authentication processes
743
789
##
744
790
 
745
791
# Executable location
746
 
#auth_executable = /usr/libexec/dovecot/dovecot-auth
 
792
#auth_executable = /usr/lib/dovecot/dovecot-auth
747
793
 
748
794
# Set max. process size in megabytes.
749
795
#auth_process_size = 256
825
871
#auth_krb5_keytab = 
826
872
 
827
873
# Do NTLM and GSS-SPNEGO authentication using Samba's winbind daemon and
828
 
# ntlm_auth helper. <doc/wiki/Authentication/Mechanisms/Winbind.txt>
 
874
# ntlm_auth helper.
 
875
# </usr/share/doc/dovecot-common/wiki/Authentication.Mechanisms.Winbind.txt>
829
876
#auth_use_winbind = no
830
877
 
831
878
# Path for Samba's ntlm_auth helper binary.
847
894
  # allow both system users (/etc/passwd) and virtual users to login without
848
895
  # duplicating the system users into virtual database.
849
896
  #
850
 
  # <doc/wiki/PasswordDatabase.txt>
 
897
  # </usr/share/doc/dovecot-common/wiki/PasswordDatabase.txt>
851
898
  #
852
899
  # By adding master=yes setting inside a passdb you make the passdb a list
853
900
  # of "master users", who can log in as anyone else. Unless you're using PAM,
854
901
  # you probably still want the destination user to be looked up from passdb
855
902
  # that it really exists. This can be done by adding pass=yes setting to the
856
 
  # master passdb. <doc/wiki/Authentication.MasterUsers.txt>
 
903
  # master passdb. </usr/share/doc/dovecot-common/wiki/Authentication.MasterUsers.txt>
857
904
 
858
905
  # Users can be temporarily disabled by adding a passdb with deny=yes.
859
906
  # If the user is found from that database, authentication will fail.
862
909
 
863
910
  #passdb passwd-file {
864
911
    # File contains a list of usernames, one per line
865
 
    #args = /etc/dovecot.deny
 
912
    #args = /etc/dovecot/dovecot.deny
866
913
    #deny = yes
867
914
  #}
868
915
 
871
918
  # so it can't be used as userdb. If you don't want to use a separate user
872
919
  # database (passwd usually), you can use static userdb.
873
920
  # REMEMBER: You'll need /etc/pam.d/dovecot file created for PAM
874
 
  # authentication to actually work. <doc/wiki/PasswordDatabase.PAM.txt>
 
921
  # authentication to actually work. </usr/share/doc/dovecot-common/wiki/PasswordDatabase.PAM.txt>
875
922
  passdb pam {
876
923
    # [session=yes] [setcred=yes] [failure_show_msg=yes] [max_requests=<n>]
877
924
    # [cache_key=<key>] [<service name>]
892
939
    # because PAM modules can do all kinds of checks besides checking password,
893
940
    # such as checking IP address. Dovecot can't know about these checks
894
941
    # without some help. cache_key is simply a list of variables (see
895
 
    # doc/wiki/Variables.txt) which must match for the cached data to be used.
 
942
    # /usr/share/doc/dovecot-common/wiki/Variables.txt) which must match
 
943
    # for the cached data to be used.
896
944
    # Here are some examples:
897
945
    #   %u - Username must match. Probably sufficient for most uses.
898
946
    #   %u%r - Username and remote IP address must match.
909
957
 
910
958
  # System users (NSS, /etc/passwd, or similiar)
911
959
  # In many systems nowadays this uses Name Service Switch, which is
912
 
  # configured in /etc/nsswitch.conf. <doc/wiki/AuthDatabase.Passwd.txt>
 
960
  # configured in /etc/nsswitch.conf. </usr/share/doc/dovecot-common/wiki/AuthDatabase.Passwd.txt>
913
961
  #passdb passwd {
914
962
    # [blocking=yes] - See userdb passwd for explanation
915
963
    #args = 
917
965
 
918
966
  # Shadow passwords for system users (NSS, /etc/shadow or similiar).
919
967
  # Deprecated by PAM nowadays.
920
 
  # <doc/wiki/PasswordDatabase.Shadow.txt>
 
968
  # </usr/share/doc/dovecot-common/wiki/PasswordDatabase.Shadow.txt>
921
969
  #passdb shadow {
922
970
    # [blocking=yes] - See userdb passwd for explanation
923
971
    #args = 
924
972
  #}
925
973
 
926
974
  # PAM-like authentication for OpenBSD.
927
 
  # <doc/wiki/PasswordDatabase.BSDAuth.txt>
 
975
  # </usr/share/doc/dovecot-common/wiki/PasswordDatabase.BSDAuth.txt>
928
976
  #passdb bsdauth {
929
977
    # [cache_key=<key>] - See cache_key in PAM for explanation.
930
978
    #args =
931
979
  #}
932
980
 
933
981
  # passwd-like file with specified location
934
 
  # <doc/wiki/AuthDatabase.PasswdFile.txt>
 
982
  # </usr/share/doc/dovecot-common/wiki/AuthDatabase.PasswdFile.txt>
935
983
  #passdb passwd-file {
936
984
    # [scheme=<default password scheme>] [username_format=<format>]
937
985
    # <Path for passwd-file>
940
988
 
941
989
  # checkpassword executable authentication
942
990
  # NOTE: You will probably want to use "userdb prefetch" with this.
943
 
  # <doc/wiki/AuthDatabase.CheckPassword.txt>
 
991
  # </usr/share/doc/dovecot-common/wiki/AuthDatabase.CheckPassword.txt>
944
992
  #passdb checkpassword {
945
993
    # Path for checkpassword binary
946
994
    #args = 
947
995
  #}
948
996
 
949
 
  # SQL database <doc/wiki/AuthDatabase.SQL.txt>
 
997
  # SQL database </usr/share/doc/dovecot-common/wiki/AuthDatabase.SQL.txt>
950
998
  #passdb sql {
951
 
    # Path for SQL configuration file, see doc/dovecot-sql-example.conf
952
 
    #args = 
 
999
    # Path for SQL configuration file
 
1000
    #args = /etc/dovecot/dovecot-sql.conf
953
1001
  #}
954
1002
 
955
 
  # LDAP database <doc/wiki/AuthDatabase.LDAP.txt>
 
1003
  # LDAP database </usr/share/doc/dovecot-common/wiki/AuthDatabase.LDAP.txt>
956
1004
  #passdb ldap {
957
 
    # Path for LDAP configuration file, see doc/dovecot-ldap-example.conf
958
 
    #args = 
 
1005
    # Path for LDAP configuration file
 
1006
    #args = /etc/dovecot/dovecot-ldap.conf
959
1007
  #}
960
1008
 
961
 
  # vpopmail authentication <doc/wiki/AuthDatabase.VPopMail.txt>
 
1009
  # vpopmail authentication </usr/share/doc/dovecot-common/wiki/AuthDatabase.VPopMail.txt>
962
1010
  #passdb vpopmail {
963
1011
    # [cache_key=<key>] - See cache_key in PAM for explanation.
964
1012
    # [quota_template=<template>] - %q expands to Maildir++ quota
970
1018
  # User database specifies where mails are located and what user/group IDs
971
1019
  # own them. For single-UID configuration use "static".
972
1020
  #
973
 
  # <doc/wiki/UserDatabase.txt>
 
1021
  # </usr/share/doc/dovecot-common/wiki/UserDatabase.txt>
974
1022
  #
975
1023
 
976
1024
  # "prefetch" user database means that the passdb already provided the
977
1025
  # needed information and there's no need to do a separate userdb lookup.
978
1026
  # This can be made to work with SQL and LDAP databases, see their example
979
1027
  # configuration files for more information how to do it.
980
 
  # <doc/wiki/UserDatabase.Prefetch.txt>
 
1028
  # </usr/share/doc/dovecot-common/wiki/UserDatabase.Prefetch.txt>
981
1029
  #userdb prefetch {
982
1030
  #}
983
1031
 
984
1032
  # System users (NSS, /etc/passwd, or similiar). In many systems nowadays this
985
1033
  # uses Name Service Switch, which is configured in /etc/nsswitch.conf.
986
 
  # <doc/wiki/AuthDatabase.Passwd.txt>
 
1034
  # </usr/share/doc/dovecot-common/wiki/AuthDatabase.Passwd.txt>
987
1035
  userdb passwd {
988
1036
    # [blocking=yes] - By default the lookups are done in the main dovecot-auth
989
1037
    # process. This setting causes the lookups to be done in auth worker
994
1042
  }
995
1043
 
996
1044
  # passwd-like file with specified location
997
 
  # <doc/wiki/AuthDatabase.PasswdFile.txt>
 
1045
  # </usr/share/doc/dovecot-common/wiki/AuthDatabase.PasswdFile.txt>
998
1046
  #userdb passwd-file {
999
1047
    # [username_format=<format>] <Path for passwd-file>
1000
1048
    #args =
1001
1049
  #}
1002
1050
 
1003
1051
  # checkpassword executable user database lookup
1004
 
  # <doc/wiki/AuthDatabase.CheckPassword.txt>
 
1052
  # </usr/share/doc/dovecot-common/wiki/AuthDatabase.CheckPassword.txt>
1005
1053
  #userdb checkpassword {
1006
1054
    # Path for checkpassword binary
1007
1055
    #args = 
1008
1056
  #}
1009
1057
 
1010
 
  # static settings generated from template <doc/wiki/UserDatabase.Static.txt>
 
1058
  # static settings generated from template </usr/share/doc/dovecot-common/wiki/UserDatabase.Static.txt>
1011
1059
  #userdb static {
1012
1060
    # Template for the fields. Can return anything a userdb could normally
1013
1061
    # return. For example:
1024
1072
    #args =
1025
1073
  #}
1026
1074
 
1027
 
  # SQL database <doc/wiki/AuthDatabase.SQL.txt>
 
1075
  # SQL database </usr/share/doc/dovecot-common/wiki/AuthDatabase.SQL.txt>
1028
1076
  #userdb sql {
1029
 
    # Path for SQL configuration file, see doc/dovecot-sql-example.conf
1030
 
    #args = 
 
1077
    # Path for SQL configuration file
 
1078
    #args = /etc/dovecot/dovecot-sql.conf
1031
1079
  #}
1032
1080
 
1033
 
  # LDAP database <doc/wiki/AuthDatabase.LDAP.txt>
 
1081
  # LDAP database </usr/share/doc/dovecot-common/wiki/AuthDatabase.LDAP.txt>
1034
1082
  #userdb ldap {
1035
 
    # Path for LDAP configuration file, see doc/dovecot-ldap-example.conf
1036
 
    #args = 
 
1083
    # Path for LDAP configuration file
 
1084
    #args = /etc/dovecot/dovecot-ldap.conf
1037
1085
  #}
1038
1086
 
1039
 
  # vpopmail <doc/wiki/AuthDatabase.VPopMail.txt>
 
1087
  # vpopmail </usr/share/doc/dovecot-common/wiki/AuthDatabase.VPopMail.txt>
1040
1088
  #userdb vpopmail {
1041
1089
  #}
1042
1090
 
1103
1151
## Dictionary server settings
1104
1152
##
1105
1153
 
1106
 
# Dictionary can be used by some plugins to store key=value lists.
1107
 
# Currently this is only used by dict quota backend. The dictionary can be
1108
 
# used either directly or though a dictionary server. The following dict block
1109
 
# maps dictionary names to URIs when the server is used. These can then be
1110
 
# referenced using URIs in format "proxy::<name>".
 
1154
# Dictionary can be used by some plugins to store key=value lists, such as
 
1155
# quota, expire and acl plugins. The dictionary can be used either directly or
 
1156
# though a dictionary server. The following dict block maps dictionary names to
 
1157
# URIs when the server is used. These can then be referenced using URIs in
 
1158
# format "proxy::<name>".
1111
1159
 
1112
1160
dict {
1113
 
  #quota = mysql:/etc/dovecot-dict-quota.conf 
 
1161
  #quota = mysql:/etc/dovecot/dovecot-dict-quota.conf
1114
1162
  #expire = db:/var/lib/dovecot/expire.db
1115
1163
}
1116
1164
 
1162
1210
  # one file for each mailbox, eg. INBOX or sub.mailbox. cache_secs parameter
1163
1211
  # specifies how many seconds to wait between stat()ing dovecot-acl file
1164
1212
  # to see if it changed.
1165
 
  #acl = vfile:/etc/dovecot-acls:cache_secs=300
 
1213
  #acl = vfile:/etc/dovecot/dovecot-acls:cache_secs=300
1166
1214
 
1167
1215
  # To let users LIST mailboxes shared by other users, Dovecot needs a
1168
1216
  # shared mailbox dictionary. For example:
1185
1233
  # until the message can be saved within quota limits. The configuration file
1186
1234
  # is a text file where each line is in format: <priority> <mailbox name>
1187
1235
  # Mails are first deleted in lowest -> highest priority number order
1188
 
  #trash = /etc/dovecot-trash.conf
 
1236
  #trash = /etc/dovecot/dovecot-trash.conf
1189
1237
 
1190
1238
  # Expire plugin. Mails are expunged from mailboxes after being there the
1191
1239
  # configurable time. The first expiration date for each mailbox is stored in
1192
1240
  # a dictionary so it can be quickly determined which mailboxes contain
1193
1241
  # expired mails. The actual expunging is done in a nightly cronjob, which
1194
1242
  # you must set up:
1195
 
  #   dovecot --exec-mail ext /usr/libexec/dovecot/expire-tool
 
1243
  #   dovecot --exec-mail ext /usr/lib/dovecot/expire-tool
1196
1244
  #expire = Trash 7 Spam 30
1197
1245
  #expire_dict = proxy::expire
1198
1246
 
1211
1259
  # Available fields: uid, box, msgid, from, subject, size, vsize, flags
1212
1260
  # size and vsize are available only for expunge and copy events.
1213
1261
  #mail_log_fields = uid box msgid size
 
1262
 
 
1263
  # Sieve plugin (http://wiki.dovecot.org/LDA/Sieve) and ManageSieve service
 
1264
  # 
 
1265
  # Location of the active script. When ManageSieve is used this is actually 
 
1266
  # a symlink pointing to the active script in the sieve storage directory. 
 
1267
  #sieve=~/.dovecot.sieve
 
1268
  #
 
1269
  # The path to the directory where the personal Sieve scripts are stored. For 
 
1270
  # ManageSieve this is where the uploaded scripts are stored.
 
1271
  #sieve_dir=~/sieve
1214
1272
}
1215
1273
 
1216
1274
# Config files can also be included. deliver doesn't support them currently.