dovecot-example.conf revision 714af786b95457703f620ff9e9e7618b5d426167
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes## Dovecot 1.0 configuration file
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# '#' character and everything after it is treated as comments. Extra spaces
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# and tabs are ignored. If you want to use either of these explicitly, put the
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# value inside quotes, eg.: key = "# char and trailing whitespace "
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Default values are shown after each value, it's not required to uncomment
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# any of the lines. Exception to this are paths, they're just examples
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# with real defaults being based on configure options. The paths listed here
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# are for configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var
0662ed52e814f8f08ef0e09956413a792584eddffuankg# --with-ssldir=/etc/ssl
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Base directory where to store runtime data.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#base_dir = /var/run/dovecot/
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Protocols we want to be serving:
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# imap imaps pop3 pop3s
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#protocols = imap imaps
70953fb44a7140fe206c3a5f011e24209c8c5c6abnicholes
70953fb44a7140fe206c3a5f011e24209c8c5c6abnicholes# IP or host address where to listen in for connections. It's not currently
16b55a35cff91315d261d1baa776138af465c4e4fuankg# possible to specify multiple addresses. "*" listens in all IPv4 interfaces.
16b55a35cff91315d261d1baa776138af465c4e4fuankg# "[::]" listens in all IPv6 interfaces, but may also listen in all IPv4
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# interfaces depending on the operating system. If you want to specify ports
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# for each service, you will need to configure these settings inside the
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# protocol imap/pop3 { ... } section, so you can specify different ports
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# for IMAP/POP3.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#listen = *
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# IP or host address where to listen in for SSL connections. Defaults
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# to above if not specified.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#ssl_listen =
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Disable SSL/TLS support.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#ssl_disable = no
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# PEM encoded X.509 SSL/TLS certificate and private key. They're opened before
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# dropping root privileges, so keep the key file unreadable by anyone but
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# root. Included doc/mkcert.sh can be used to easily generate self-signed
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# certificate, just make sure to update the domains in dovecot-openssl.cnf
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#ssl_cert_file = /etc/ssl/certs/dovecot.pem
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#ssl_key_file = /etc/ssl/private/dovecot.pem
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# File containing trusted SSL certificate authorities. Usually not needed.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#ssl_ca_file =
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Request client to send a certificate.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#ssl_verify_client_cert = no
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# SSL parameter file. Master process generates this file for login processes.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# It contains Diffie Hellman and RSA parameters.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#ssl_parameters_file = /var/run/dovecot/ssl-parameters.dat
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# How often to regenerate the SSL parameters file. Generation is quite CPU
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# intensive operation. The value is in hours, 0 disables regeneration
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# entirely.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#ssl_parameters_regenerate = 24
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
ac7985784d08a3655291f24f711812b4d8b1cbcffuankg# SSL ciphers to use
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#ssl_cipher_list = ALL:!LOW
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Disable LOGIN command and all other plaintext authentications unless
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# SSL/TLS is used (LOGINDISABLED capability). Note that 127.*.*.* and
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# IPv6 ::1 addresses are considered secure, this setting has no effect if
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# you connect from those addresses.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#disable_plaintext_auth = yes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Use this logfile instead of syslog(). /dev/stderr can be used if you want to
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# use stderr for logging (ONLY /dev/stderr - otherwise it is closed).
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#log_path =
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# For informational messages, use this logfile instead of the default
ac7985784d08a3655291f24f711812b4d8b1cbcffuankg#info_log_path =
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Prefix for each line written to log file. % codes are in strftime(3)
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# format.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#log_timestamp = "%b %d %H:%M:%S "
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Syslog facility to use if you're logging to syslog. Usually if you don't
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# want to use "mail", you'll use local0..local7. Also other standard
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# facilities are supported.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#syslog_facility = mail
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes##
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes## Login processes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes##
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Directory where authentication process places authentication UNIX sockets
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# which login needs to be able to connect to. The sockets are created when
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# running as root, so you don't have to worry about permissions. Note that
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# everything in this directory is deleted when Dovecot is started.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#login_dir = /var/run/dovecot/login
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# chroot login process to the login_dir. Only reason not to do this is if you
ac7985784d08a3655291f24f711812b4d8b1cbcffuankg# wish to run the whole Dovecot without roots.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# http://wiki.dovecot.org/Rootless
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#login_chroot = yes
ac7985784d08a3655291f24f711812b4d8b1cbcffuankg
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# User to use for the login process. Create a completely new user for this,
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# and don't use it anywhere else. The user must also belong to a group where
0a39e7683f6611d66c55712f50bb240428d832a1bnicholes# only it has access, it's used to control access for authentication process.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Note that this user is NOT used to access mails.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# http://wiki.dovecot.org/UserIds
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#login_user = dovecot
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Set max. process size in megabytes. If you don't use
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# login_process_per_connection you might need to grow this.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#login_process_size = 32
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
ac7985784d08a3655291f24f711812b4d8b1cbcffuankg# Should each login be processed in it's own process (yes), or should one
0662ed52e814f8f08ef0e09956413a792584eddffuankg# login process be allowed to process multiple connections (no)? Yes is more
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# secure, espcially with SSL/TLS enabled. No is faster since there's no need
ac7985784d08a3655291f24f711812b4d8b1cbcffuankg# to create processes all the time.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#login_process_per_connection = yes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Number of login processes to create. If login_process_per_connection is
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# yes, this is the number of extra processes waiting for users to log in.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#login_processes_count = 3
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Maximum number of extra login processes to create. The extra process count
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# usually stays at login_processes_count, but when multiple users start logging
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# in at the same time more extra processes are created. To prevent fork-bombing
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# we check only once in a second if new processes should be created - if all
0662ed52e814f8f08ef0e09956413a792584eddffuankg# of them are used at the time, we double their amount until limit set by this
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# setting is reached. This setting is used only if login_process_per_use is yes.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#login_max_processes_count = 128
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Maximum number of connections allowed in login state. When this limit is
0662ed52e814f8f08ef0e09956413a792584eddffuankg# reached, the oldest connections are dropped. If login_process_per_connection
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# is no, this is a per-process value, so the absolute maximum number of users
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# logging in actually login_processes_count * max_logging_users.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#login_max_logging_users = 256
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Greeting message for clients.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#login_greeting = Dovecot ready.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Space-separated list of elements we want to log. The elements which have
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# a non-empty variable value are joined together to form a comma-separated
0662ed52e814f8f08ef0e09956413a792584eddffuankg# string.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#login_log_format_elements = user=<%u> method=%m rip=%r lip=%l %c
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
ac7985784d08a3655291f24f711812b4d8b1cbcffuankg# Login log format. %$ contains login_log_format_elements string, %s contains
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# the data we want to log.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#login_log_format = %$: %s
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
ac7985784d08a3655291f24f711812b4d8b1cbcffuankg##
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes## Mail processes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes##
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Maximum number of running mail processes. When this limit is reached,
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# new users aren't allowed to log in.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#max_mail_processes = 1024
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Show more verbose process titles (in ps). Currently shows user name and
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# IP address. Useful for seeing who are actually using the IMAP processes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# (eg. shared mailboxes or if same uid is used for multiple accounts).
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#verbose_proctitle = no
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Show protocol level SSL errors.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#verbose_ssl = no
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Valid UID range for users, defaults to 500 and above. This is mostly
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# to make sure that users can't log in as daemons or other system users.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Note that denying root logins is hardcoded to dovecot binary and can't
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# be done even if first_valid_uid is set to 0.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#first_valid_uid = 500
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#last_valid_uid = 0
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Valid GID range for users, defaults to non-root/wheel. Users having
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# non-valid GID as primary group ID aren't allowed to log in. If user
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# belongs to supplementary groups with non-valid GIDs, those groups are
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# not set.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#first_valid_gid = 1
cf7ca2f9eaa6523fefcccba4287b91637391fb51fuankg#last_valid_gid = 0
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Grant access to these extra groups for mail processes. Typical use would be
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# to give "mail" group write access to /var/mail to be able to create dotlocks.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#mail_extra_groups =
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# ':' separated list of directories under which chrooting is allowed for mail
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# processes (ie. /var/mail will allow chrooting to /var/mail/foo/bar too).
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# This setting doesn't affect login_chroot or auth_chroot variables.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# WARNING: Never add directories here which local users can modify, that
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# may lead to root exploit. Usually this should be done only if you don't
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# allow shell access for users. See doc/configuration.txt for more information.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#valid_chroot_dirs =
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Default chroot directory for mail processes. This can be overridden for
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# specific users in user database by giving /./ in user's home directory
ac7985784d08a3655291f24f711812b4d8b1cbcffuankg# (eg. /home/./user chroots into /home). Note that usually there is no real
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# need to do chrooting, Dovecot doesn't allow users to access files outside
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# their mail directory anyway.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#mail_chroot =
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Enable mail process debugging. This can help you figure out why Dovecot
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# isn't finding your mails.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#mail_debug = no
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# Default MAIL environment to use when it's not set. By leaving this empty
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# dovecot tries to do some automatic detection as described in
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# doc/mail-storages.txt. There's a few special variables you can use, eg.:
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# %u - username
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# %n - user part in user@domain, same as %u if there's no domain
8ffac2c334103c0336602aaede650cb578611151fuankg# %d - domain part in user@domain, empty if there's no domain
8ffac2c334103c0336602aaede650cb578611151fuankg# %h - home directory
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# See doc/variables.txt for full list. Some examples:
ac7985784d08a3655291f24f711812b4d8b1cbcffuankg#
ac7985784d08a3655291f24f711812b4d8b1cbcffuankg# default_mail_env = maildir:/var/mail/%1u/%u/Maildir
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# default_mail_env = mbox:~/mail/:INBOX=/var/mail/%u
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# default_mail_env = mbox:/var/mail/%d/%n/:INDEX=/var/indexes/%d/%n
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#default_mail_env =
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
ac7985784d08a3655291f24f711812b4d8b1cbcffuankg# If you need to set multiple mailbox locations or want to change default
ac7985784d08a3655291f24f711812b4d8b1cbcffuankg# namespace settings, you can do it by defining namespace sections:
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# You can have private, shared and public namespaces. The only difference
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# between them is how Dovecot announces them to client via NAMESPACE
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# extension. Shared namespaces are meant for user-owned mailboxes which are
ac7985784d08a3655291f24f711812b4d8b1cbcffuankg# shared to other users, while public namespaces are for more globally
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# accessible mailboxes.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# REMEMBER: If you add any namespaces, the default namespace must be added
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# explicitly, ie. default_mail_env does nothing unless you have a namespace
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# without a location setting. Default namespace is simply done by having a
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes# namespace with empty prefix.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes#namespace private {
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes # Hierarchy separator to use. You should use the same separator for all
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes # namespaces or some clients get confused. '/' is usually a good one.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes #separator = /
ac7985784d08a3655291f24f711812b4d8b1cbcffuankg
0662ed52e814f8f08ef0e09956413a792584eddffuankg # Prefix required to access this namespace. This needs to be different for
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes # all namespaces. For example "Public/".
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes #prefix =
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes # Physical location of the mailbox. This is in same format as
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes # default_mail_env, which is also the default for it.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes #location =
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes # There can be only one INBOX, and this setting defines which namespace
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes # has it.
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes #inbox = yes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes # If namespace is hidden, it's not advertised to clients via NAMESPACE
0662ed52e814f8f08ef0e09956413a792584eddffuankg # extension or shown in LIST replies. This is mostly useful when converting
3c937b528ca923d5b51e63def9f888af4a77bb40bnicholes # from another server with different namespaces which you want to depricate
# but still keep working. For example you can create hidden namespaces with
# prefixes "~/mail/", "~%u/mail/" and "mail/".
#hidden = yes
#}
# Space-separated list of fields to initially save into cache file. Currently
# these fields are allowed:
#
# flags, date.sent, date.received, size.virtual, size.physical
# mime.parts, imap.body, imap.bodystructure
#
# Different IMAP clients work in different ways, so they benefit from
# different cached fields. Some do not benefit from them at all. Caching more
# than necessary generates useless disk I/O, so you don't want to do that
# either.
#
# Dovecot attempts to automatically figure out what client wants and it keeps
# only that. However the first few times a mailbox is opened, Dovecot hasn't
# yet figured out what client needs, so it may not perform optimally. If you
# know what fields the majority of your clients need, it may be useful to set
# these fields by hand. If client doesn't actually use them, Dovecot will
# eventually drop them.
#
# Usually you should just leave this field alone. The potential benefits are
# typically unnoticeable.
#mail_cache_fields =
# Space-separated list of fields that Dovecot should never save to cache file.
# Useful if you want to save disk space at the cost of more I/O when the fields
# needed.
#mail_never_cache_fields =
# When IDLE command is running, mailbox is checked once in a while to see if
# there are any new mails or other changes. This setting defines the minimum
# time to wait between those checks. Dovecot is however able to use dnotify
# and inotify with Linux to reply immediately after the change occurs.
#mailbox_idle_check_interval = 30
# Allow full filesystem access to clients. There's no access checks other than
# what the operating system does for the active UID/GID. It works with both
# maildir and mboxes, allowing you to prefix mailboxes names with eg. /path/
# or ~user/.
#mail_full_filesystem_access = no
# Maximum allowed length for mail keyword name. It's only forced when trying
# to create new keywords.
#mail_max_keyword_length = 50
# Save mails with CR+LF instead of plain LF. This makes sending those mails
# take less CPU, especially with sendfile() syscall with Linux and FreeBSD.
# But it also creates a bit more disk I/O which may just make it slower.
# Also note that if other software reads the mboxes/maildirs, they may handle
# the extra CRs wrong and cause problems.
#mail_save_crlf = no
# Use mmap() instead of read() to read mail files. read() seems to be a bit
# faster with my Linux/x86 and it's better with NFS, so that's the default.
# Note that OpenBSD 3.3 and older don't work right with mail_read_mmaped = yes.
#mail_read_mmaped = no
# Don't use mmap() at all. This is required if you store indexes in remote
# filesystems (NFS or clustered filesystem).
#mmap_disable = no
# Don't write() to mmaped files. This is required for some operating systems
# which use separate caches for them, such as OpenBSD.
#mmap_no_write = no
# Locking method for index files. Alternatives are fcntl, flock and dotlock.
# Dotlocking uses some tricks which may create more disk I/O than other locking
# methods. NOTE: If you use NFS, remember to change also mmap_disable setting!
# Solaris doesn't support flock, so Solaris users need to change this to fcntl.
#lock_method = flock
# By default LIST command returns all entries in maildir beginning with dot.
# Enabling this option makes Dovecot return only entries which are directories.
# This is done by stat()ing each entry, so it causes more disk I/O.
# (For systems setting struct dirent->d_type, this check is free and it's
# done always regardless of this setting)
#maildir_stat_dirs = no
# Copy mail to another folders using hard links. This is much faster than
# actually copying the file. This is problematic only if something modifies
# the mail in one folder but doesn't want it modified in the others. I don't
# know any MUA which would modify mail files directly. IMAP protocol also
# requires that the mails don't change, so it would be problematic in any case.
# If you care about performance, enable it.
#maildir_copy_with_hardlinks = no
# Which locking methods to use for locking mbox. There's four available:
# dotlock: Create <mailbox>.lock file. This is the oldest and most NFS-safe
# solution. If you want to use /var/mail/ like directory, the users
# will need write access to that directory.
# fcntl : Use this if possible. Works with NFS too if lockd is used.
# flock : May not exist in all systems. Doesn't work with NFS.
# lockf : May not exist in all systems. Doesn't work with NFS.
#
# You can use multiple locking methods; if you do the order they're declared
# in is important to avoid deadlocks if other MTAs/MUAs are using multiple
# locking methods as well. Some operating systems don't allow using some of
# them simultaneously.
#mbox_read_locks = fcntl
#mbox_write_locks = dotlock fcntl
# Maximum time in seconds to wait for lock (all of them) before aborting.
#mbox_lock_timeout = 300
# If dotlock exists but the mailbox isn't modified in any way, override the
# lock file after this many seconds.
#mbox_dotlock_change_timeout = 30
# When mbox changes unexpectedly we have to fully read it to find out what
# changed. If the mbox is large this can take a long time. Since the change
# is usually just a newly appended mail, it'd be faster to simply read the
# new mails. If this setting is enabled, Dovecot does this but still safely
# fallbacks to re-reading the whole mbox file whenever something in mbox isn't
# how it's expected to be. The only real downside to this setting is that if
# some other MUA changes message flags, Dovecot doesn't notice it immediately.
# Note that a full sync is done with SELECT, EXAMINE, EXPUNGE and CHECK
# commands.
#mbox_dirty_syncs = yes
# Like mbox_dirty_syncs, but don't do full syncs even with SELECT, EXAMINE,
# EXPUNGE or CHECK commands. If this is set, mbox_dirty_syncs is ignored.
#mbox_very_dirty_syncs = no
# Delay writing mbox headers until doing a full write sync (EXPUNGE and CHECK
# commands and when closing the mailbox). This is especially useful for POP3
# where clients often delete all mails. The downside is that our changes
# aren't immediately visible to other MUAs.
#mbox_lazy_writes = yes
# umask to use for mail files and directories
#umask = 0077
# Drop all privileges before exec()ing the mail process. This is mostly
# meant for debugging, otherwise you don't get core dumps. It could be a small
# security risk if you use single UID for multiple users, as the users could
# ptrace() each others processes then.
#mail_drop_priv_before_exec = no
# Set max. process size in megabytes. Most of the memory goes to mmap()ing
# files, so it shouldn't harm much even if this limit is set pretty high.
#mail_process_size = 256
# Log prefix for mail processes. See doc/variables.txt for list of possible
# variables you can use.
#mail_log_prefix = "%Us(%u): "
##
## IMAP specific settings
##
protocol imap {
# Login executable location.
#login_executable = /usr/libexec/dovecot/imap-login
# IMAP executable location
#mail_executable = /usr/libexec/dovecot/imap
# This would write rawlogs into ~/dovecot.rawlog/ directory:
#mail_executable = /usr/libexec/dovecot/rawlog /usr/libexec/dovecot/imap
# Maximum IMAP command line length in bytes. Some clients generate very long
# command lines with huge mailboxes, so you may need to raise this if you get
# "Too long argument" or "IMAP command line too large" errors often.
#imap_max_line_length = 65536
# Support for dynamically loadable modules.
#mail_use_modules = no
#mail_modules = /usr/lib/dovecot/imap
# Send IMAP capabilities in greeting message. This makes it unnecessary for
# clients to request it with CAPABILITY command, so it saves one round-trip.
# Many clients however don't understand it and ask the CAPABILITY anyway.
#login_greeting_capability = no
# Workarounds for various client bugs:
# delay-newmail:
# Send EXISTS/RECENT new mail notifications only when replying to NOOP
# and CHECK commands. Some clients ignore them otherwise, for example
# OSX Mail. Outlook Express breaks more badly though, without this it
# may show user "Message no longer in server" errors. Note that OE6 still
# breaks even with this workaround if synchronization is set to
# "Headers Only".
# outlook-idle:
# Outlook and Outlook Express never abort IDLE command, so if no mail
# arrives in half a hour, Dovecot closes the connection. This is still
# fine, except Outlook doesn't connect back so you don't see if new mail
# arrives.
# netscape-eoh:
# Netscape 4.x breaks if message headers don't end with the empty "end of
# headers" line. Normally all messages have this, but setting this
# workaround makes sure that Netscape never breaks by adding the line if
# it doesn't exist. This is done only for FETCH BODY[HEADER.FIELDS..]
# commands. Note that RFC says this shouldn't be done.
# tb-extra-mailbox-sep:
# With mbox storage a mailbox can contain either mails or submailboxes,
# but not both. Thunderbird separates these two by forcing server to
# accept '/' suffix in mailbox names in subscriptions list.
#imap_client_workarounds = outlook-idle
}
##
## POP3 specific settings
##
protocol pop3 {
# Login executable location.
#login_executable = /usr/libexec/dovecot/pop3-login
# POP3 executable location
#mail_executable = /usr/libexec/dovecot/pop3
# Don't try to set mails non-recent or seen with POP3 sessions. This is
# mostly intended to reduce disk I/O. With maildir it doesn't move files
# from new/ to cur/, with mbox it doesn't write Status-header.
#pop3_no_flag_updates = no
# Support LAST command which exists in old POP3 specs, but has been removed
# from new ones. Some clients still wish to use this though. Enabling this
# makes RSET command clear all \Seen flags from messages.
#pop3_enable_last = no
# POP3 UIDL format to use. You can use following variables:
#
# %v - Mailbox UIDVALIDITY
# %u - Mail UID
# %m - MD5 sum of the mailbox headers in hex (mbox only)
# %f - filename (maildir only)
#
# If you want UIDL compatibility with other POP3 servers, use:
# UW's ipop3d : %08Xv%08Xu
# Courier version 0 : %f
# Courier version 1 : %u
# Courier version 2 : %v-%u
# Cyrus (<= 2.1.3) : %u
# Cyrus (>= 2.1.4) : %v.%u
# Older Dovecots : %v.%u
#
# Note that Outlook 2003 seems to have problems with %v.%u format which was
# Dovecot's default, so if you're building a new server it would be a good
# idea to change this. %08Xu%08Xv should be pretty fail-safe.
#
# NOTE: Nowadays this is required to be set explicitly, since the old
# default was bad but it couldn't be changed without breaking existing
# installations. %08Xu%08Xv will be the new default, so use it for new
# installations.
#
#pop3_uidl_format =
# POP3 logout format string:
# %t - number of TOP commands
# %T - number of bytes sent to client as a result of TOP command
# %r - number of RETR commands
# %R - number of bytes sent to client as a result of RETR command
# %d - number of deleted messages
# %m - number of messages (before deletion)
# %s - mailbox size in bytes (before deletion)
#pop3_logout_format = top=%t/%T, retr=%r/%R, del=%d/%m, size=%s
# Support for dynamically loadable modules.
#mail_use_modules = no
#mail_modules = /usr/lib/dovecot/pop3
# Workarounds for various client bugs:
# outlook-no-nuls:
# Outlook and Outlook Express hang if mails contain NUL characters.
# This setting replaces them with 0x80 character.
# oe-ns-eoh:
# Outlook Express and Netscape Mail breaks if end of headers-line is
# missing. This option simply sends it if it's missing.
#pop3_client_workarounds =
}
##
## Authentication processes
##
# Executable location
#auth_executable = /usr/libexec/dovecot/dovecot-auth
# Set max. process size in megabytes.
#auth_process_size = 256
# Authentication cache size in kilobytes. 0 means it's disabled.
# Note that bsdauth, PAM and vpopmail require cache_key to be set for caching
# to be used. Also note that currently auth cache doesn't work very well if
# you're using multiple passdbs with same usernames in them.
#auth_cache_size = 0
# Time to live in seconds for cached data. After this many seconds the cached
# record is no longer used, *except* if the main database lookup returns
# internal failure.
#auth_cache_ttl = 3600
# Space separated list of realms for SASL authentication mechanisms that need
# them. You can leave it empty if you don't want to support multiple realms.
# Many clients simply use the first one listed here, so keep the default realm
# first.
#auth_realms =
# Default realm/domain to use if none was specified. This is used for both
# SASL realms and appending @domain to username in plaintext logins.
#auth_default_realm =
# List of allowed characters in username. If the user-given username contains
# a character not listed in here, the login automatically fails. This is just
# an extra check to make sure user can't exploit any potential quote escaping
# vulnerabilities with SQL/LDAP databases. If you want to allow all characters,
# set this value to empty.
#auth_username_chars = abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ01234567890.-_@
# Username character translations before it's looked up from databases. The
# value contains series of from -> to characters. For example "#@/@" means
# that '#' and '/' characters are translated to '@'.
#auth_username_translation =
# Username to use for users logging in with ANONYMOUS SASL mechanism
#auth_anonymous_username = anonymous
# More verbose logging. Useful for figuring out why authentication isn't
# working.
#auth_verbose = no
# Even more verbose logging for debugging purposes. Shows for example SQL
# queries.
#auth_debug = no
# Maximum number of dovecot-auth worker processes. They're used to execute
# blocking passdb and userdb queries (eg. MySQL and PAM). They're
# automatically created and destroyed as needed.
#auth_worker_max_count = 30
# Kerberos keytab to use for the GSSAPI mechanism. Will use the system
# default (usually /etc/krb5.keytab) if not specified.
#auth_krb5_keytab =
auth default {
# Space separated list of wanted authentication mechanisms:
# plain digest-md5 cram-md5 apop anonymous gssapi
mechanisms = plain
#
# Password database is used to verify user's password (and nothing more).
# You can have multiple passdbs and userdbs. This is useful if you want to
# allow both system users (/etc/passwd) and virtual users to login without
# duplicating the system users into virtual database.
#
# http://wiki.dovecot.org/Authentication
#
# Users can be temporarily disabled by adding a passdb with deny=yes.
# If the user is found from that database, authentication will fail.
# The deny passdb should always be specified before others, so it gets
# checked first. Here's an example:
#passdb passwd-file {
# File contains a list of usernames, one per line
#args = /etc/dovecot.deny
#deny = yes
#}
# PAM authentication. Preferred nowadays by most systems.
# Note that PAM can only be used to verify if user's password is correct,
# so it can't be used as userdb. If you don't want to use a separate user
# database (passwd usually), you can use static userdb.
passdb pam {
# [session=yes] [cache_key=<key>] [<service name>]
#
# session=yes makes Dovecot open and immediately close PAM session. Some
# PAM plugins need this to work, such as pam_mkhomedir.
#
# cache_key can be used to enable authentication caching for PAM
# (auth_cache_size also needs to be set). It isn't enabled by default
# because PAM modules can do all kinds of checks besides checking password,
# such as checking IP address. Dovecot can't know about these checks
# without some help. cache_key is simply a list of variables (see
# doc/variables.txt) which must match for the cached data to be used.
# Here are some examples:
# %u - Username must match. Probably sufficient for most uses.
# %u%r - Username and remote IP address must match.
# %u%s - Username and service (ie. IMAP, POP3) must match.
#
# If service name is "*", it means the authenticating service name
# is used, eg. pop3 or imap.
#
# Some examples:
# args = session=yes *
# args = cache_key=%u dovecot
#args = dovecot
}
# /etc/passwd or similar, using getpwnam()
# In many systems nowadays this uses Name Service Switch, which is
# configured in /etc/nsswitch.conf.
#passdb passwd {
#}
# /etc/shadow or similiar, using getspnam(). Deprecated by PAM nowadays.
#passdb shadow {
#}
# BSD authentication. Used by at least OpenBSD.
#passdb bsdauth {
# [cache_key=<key>] - See cache_key in PAM for explanation.
#args =
#}
# passwd-like file with specified location
#passdb passwd-file {
# Path for passwd-file
#args =
#}
# checkpassword executable authentication
# NOTE: You will probably want to use "userdb prefetch" with this.
#passdb checkpassword {
# Path for checkpassword binary
#args =
#}
# SQL database
#passdb sql {
# Path for SQL configuration file, see doc/dovecot-sql.conf for example
#args =
#}
# LDAP database
#passdb ldap {
# Path for LDAP configuration file, see doc/dovecot-ldap.conf for example
#args =
#}
# vpopmail authentication
#passdb vpopmail {
# [cache_key=<key>] - See cache_key in PAM for explanation.
#args =
#}
#
# User database specifies where mails are located and what user/group IDs
# own them. For single-UID configuration use "static".
#
# http://wiki.dovecot.org/Authentication
# http://wiki.dovecot.org/VirtualUsers
#
# /etc/passwd or similar, using getpwnam()
# In many systems nowadays this uses Name Service Switch, which is
# configured in /etc/nsswitch.conf.
userdb passwd {
}
# passwd-like file with specified location
#userdb passwd-file {
# Path for passwd-file
#args =
#}
# static settings generated from template
#userdb static {
# Template for settings. Can return anything a userdb could normally
# return, eg.: uid, gid, home, mail, nice
#
# A few examples:
#
# args = uid=500 gid=500 home=/var/mail/%u
# args = uid=500 gid=500 home=/home/%u mail=mbox:/home/%u/mail nice=10
#
#args =
#}
# SQL database
#userdb sql {
# Path for SQL configuration file, see doc/dovecot-sql.conf for example
#args =
#}
# LDAP database
#userdb ldap {
# Path for LDAP configuration file, see doc/dovecot-ldap.conf for example
#args =
#}
# vpopmail
#userdb vpopmail {
#}
# "prefetch" user database means that the passdb already provided the
# needed information and there's no need to do a separate userdb lookup.
# This can be made to work with SQL and LDAP databases, see their example
# configuration files for more information how to do it.
# http://wiki.dovecot.org/AuthSpecials
#userdb prefetch {
#}
# User to use for the process. This user needs access to only user and
# password databases, nothing else. Only shadow and pam authentication
# requires roots, so use something else if possible. Note that passwd
# authentication with BSDs internally accesses shadow files, which also
# requires roots. Note that this user is NOT used to access mails.
# That user is specified by userdb above.
user = root
# Directory where to chroot the process. Most authentication backends don't
# work if this is set, and there's no point chrooting if auth_user is root.
# Note that valid_chroot_dirs isn't needed to use this setting.
#chroot =
# Number of authentication processes to create
#count = 1
# Require a valid SSL client certificate or the authentication fails.
#ssl_require_client_cert = no
# Take the username from client's SSL certificate, using X509_NAME_oneline()
# which typically uses subject's Distinguished Name.
#ssl_username_from_cert = no
}
# It's possible to export the authentication interface to other programs,
# for example SMTP server which supports talking to Dovecot. Client socket
# handles the actual authentication - you give it a username and password
# and it returns OK or failure. So it's pretty safe to allow anyone access to
# it. Master socket is used to a) query if given client was successfully
# authenticated, b) userdb lookups.
# listener sockets will be created by Dovecot's master process using the
# settings given inside the auth section
#auth default_with_listener {
# mechanisms = plain
# passdb passwd {
# }
# userdb pam {
# }
# socket listen {
# master {
# path = /var/run/dovecot-auth-master
# # WARNING: Giving untrusted users access to master socket may be a
# # security risk, don't give too wide permissions to it!
# #mode = 0600
# # Default user/group is the one who started dovecot-auth (root)
# #user =
# #group =
# }
# client {
# path = /var/run/dovecot-auth-client
# mode = 0660
# }
# }
#}
# connect sockets are assumed to be already running, Dovecot's master
# process only tries to connect to them. They don't need any other settings
# than path for the master socket, as the configuration is done elsewhere.
# Note that the client sockets must exist in login_dir.
#auth external {
# socket connect {
# master {
# path = /var/run/dovecot-auth-master
# }
# }
#}