863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen## Dovecot configuration file
0992011130e9d0a498ca860ddbe4028398a530c5Timo Sirainen# If you're in a hurry, see http://wiki2.dovecot.org/QuickConfiguration
bfa244238be8eafb1aa6df689975bffc4ab3aad2Pascal Volk# "doveconf -n" command gives a clean output of the changed settings. Use it
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# instead of copy&pasting files when posting to the Dovecot mailing list.
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# '#' character and everything after it is treated as comments. Extra spaces
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# and tabs are ignored. If you want to use either of these explicitly, put the
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# value inside quotes, eg.: key = "# char and trailing whitespace "
4578f6ac39e5deeefbb7878c0e47b0ce42ef81baTimo Sirainen# Most (but not all) settings can be overridden by different protocols and/or
4578f6ac39e5deeefbb7878c0e47b0ce42ef81baTimo Sirainen# source/destination IPs by placing the settings inside sections, for example:
4578f6ac39e5deeefbb7878c0e47b0ce42ef81baTimo Sirainen# protocol imap { }, local 127.0.0.1 { }, remote 10.0.0.0/8 { }
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# Default values are shown for each setting, it's not required to uncomment
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# those. These are exceptions to this though: No sections (e.g. namespace {})
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# or plugin settings are added by default, they're listed only as examples.
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# Paths are also just examples with the real defaults being based on configure
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# options. The paths listed here are for configure --prefix=/usr
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# --sysconfdir=/etc --localstatedir=/var
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# Protocols we want to be serving.
2cbbe9b4829adb184c83dbf780316f4144559054Stephan Bosch#protocols = imap pop3 lmtp submission
b8ded920c25659293778ee37b9c2aade56a93936Timo Sirainen# A comma separated list of IPs or hosts where to listen in for connections.
efbe5bb60e920e33b27049d13f42147efde9bca8Timo Sirainen# "*" listens in all IPv4 interfaces, "::" listens in all IPv6 interfaces.
efbe5bb60e920e33b27049d13f42147efde9bca8Timo Sirainen# If you want to specify non-default ports or anything more complex,
efbe5bb60e920e33b27049d13f42147efde9bca8Timo Sirainen#listen = *, ::
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# Base directory where to store runtime data.
328501937a41891d9d19a2b6a45797daa5955f1dTimo Sirainen# Name of this instance. In multi-instance setup doveadm and other commands
328501937a41891d9d19a2b6a45797daa5955f1dTimo Sirainen# can use -i <instance_name> to select which instance is used (an alternative
328501937a41891d9d19a2b6a45797daa5955f1dTimo Sirainen# to -c <config_path>). The instance name is also added to Dovecot processes
328501937a41891d9d19a2b6a45797daa5955f1dTimo Sirainen# in ps output.
d646824bfec10f09b1365d0636154a00745b9af3Timo Sirainen#instance_name = dovecot
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# Greeting message for clients.
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen#login_greeting = Dovecot ready.
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# Space separated list of trusted network ranges. Connections from these
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# IPs are allowed to override their IP addresses and ports (for logging and
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# for authentication checks). disable_plaintext_auth is also ignored for
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# these networks. Typically you'd specify your IMAP proxy servers here.
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen#login_trusted_networks =
e3d7df2094cae22f3c76cffc14d08999226cf76bTimo Sirainen# Space separated list of login access check sockets (e.g. tcpwrap)
79977d368df2efc3f3dc0bbb260748b076538103Timo Sirainen#login_access_sockets =
77ba9626cb06afa8339f707dad04207d3fce9b89Timo Sirainen# With proxy_maybe=yes if proxy destination matches any of these IPs, don't do
77ba9626cb06afa8339f707dad04207d3fce9b89Timo Sirainen# proxying. This isn't necessary normally, but may be useful if the destination
77ba9626cb06afa8339f707dad04207d3fce9b89Timo Sirainen# IP is e.g. a load balancer's IP.
77ba9626cb06afa8339f707dad04207d3fce9b89Timo Sirainen#auth_proxy_self =
ce78f5edeb05611677a50034e5e8ddc4c72d446aTimo Sirainen# Show more verbose process titles (in ps). Currently shows user name and
ce78f5edeb05611677a50034e5e8ddc4c72d446aTimo Sirainen# IP address. Useful for seeing who are actually using the IMAP processes
ce78f5edeb05611677a50034e5e8ddc4c72d446aTimo Sirainen# (eg. shared mailboxes or if same uid is used for multiple accounts).
ce78f5edeb05611677a50034e5e8ddc4c72d446aTimo Sirainen#verbose_proctitle = no
9bc82408a22871204f75c62ba8cc4fa775367f5fTimo Sirainen# Should all processes be killed when Dovecot master process shuts down.
9bc82408a22871204f75c62ba8cc4fa775367f5fTimo Sirainen# Setting this to "no" means that Dovecot can be upgraded without
9bc82408a22871204f75c62ba8cc4fa775367f5fTimo Sirainen# forcing existing client connections to close (although that could also be
9bc82408a22871204f75c62ba8cc4fa775367f5fTimo Sirainen# a problem if the upgrade is e.g. because of a security fix).
9bc82408a22871204f75c62ba8cc4fa775367f5fTimo Sirainen#shutdown_clients = yes
71df09024cea5f2faa93da3bb9513ee96ba6bf22Timo Sirainen# If non-zero, run mail commands via this many connections to doveadm server,
71df09024cea5f2faa93da3bb9513ee96ba6bf22Timo Sirainen# instead of running them directly in the same process.
71df09024cea5f2faa93da3bb9513ee96ba6bf22Timo Sirainen#doveadm_worker_count = 0
71df09024cea5f2faa93da3bb9513ee96ba6bf22Timo Sirainen# UNIX socket or host:port used for connecting to doveadm server
71df09024cea5f2faa93da3bb9513ee96ba6bf22Timo Sirainen#doveadm_socket_path = doveadm-server
515ec47755ee051aaab8e3c54b8797f330034124Timo Sirainen# Space separated list of environment variables that are preserved on Dovecot
515ec47755ee051aaab8e3c54b8797f330034124Timo Sirainen# startup and passed down to all of its child processes. You can also give
515ec47755ee051aaab8e3c54b8797f330034124Timo Sirainen# key=value pairs to always set specific settings.
515ec47755ee051aaab8e3c54b8797f330034124Timo Sirainen#import_environment = TZ
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen## Dictionary server settings
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# Dictionary can be used to store key=value lists. This is used by several
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# plugins. The dictionary can be accessed either directly or though a
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# dictionary server. The following dict block maps dictionary names to URIs
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# when the server is used. These can then be referenced using URIs in format
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# "proxy::<name>".
a047c5a03aac43fab47121c7374ae7d9043cf732Timo Sirainen #quota = mysql:/etc/dovecot/dovecot-dict-sql.conf.ext
a047c5a03aac43fab47121c7374ae7d9043cf732Timo Sirainen #expire = sqlite:/etc/dovecot/dovecot-dict-sql.conf.ext
a1f2b44a1baabdcf9584c31bd7571b96edaa1e1dTimo Sirainen# Most of the actual configuration gets included below. The filenames are
a1f2b44a1baabdcf9584c31bd7571b96edaa1e1dTimo Sirainen# first sorted by their ASCII value and parsed in that order. The 00-prefixes
a1f2b44a1baabdcf9584c31bd7571b96edaa1e1dTimo Sirainen# in filenames are intended to make it easier to understand the ordering.
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# A config file can also tried to be included without giving an error if
863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainen# it's not found: