2.3 to 2.4 | Dovecot CE

2.3 to 2.4 | Dovecot CE
Skip to content
Upgrading Dovecot CE from 2.3 to 2.4
Upgrade Path
Before upgrading, please look at the list of removed features carefully.
If you are doing in-place upgrade, ensure that you first upgrade to latest 2.3 release, and then upgrade to 2.4.
Alternatively, you can
migrate
your data to new setup.
Example Configuration
The old v2.3 example configuration has been converted to v2.4 once. It's not being kept up-to-date afterwards, but it can be helpful:
Upgrading tool
For configuration conversion assistance, we provide
that can be used to convert your 2.3 configuration into 2.4.
Dovecot CE
Required Admin Actions
Sieve
Global Sieve scripts must be recompiled. See
sievec
Configuration Changes
WARNING
Dovecot 2.3.x settings will NOT work unless the configuration is changed as described in this section.
Required Settings
The first setting in
dovecot.conf
MUST
now be
dovecot_config_version
. This helps to avoid unexpected configuration changes in the future.
Another new required setting is
dovecot_storage_version
. This helps to avoid unexpected storage file format incompatibilities.
Note that the configuration syntax has been changed, and your old configuration
will not
work without changes.
Configuration Redesign
See
Dovecot Config File Syntax
for the new configuration syntax. This is similar to v2.3, but different in some ways. Especially the configuration is no longer hierarchical - all settings are global settings and can be used anywhere (although they might not actually do anything there). Settings can be inside various filters to specify where they are wanted to be used.
To avoid repetition in setting name prefixes, they are automatically attempted to be prefixed to their parent filter names. For example these are equivalent for the
passdb_sql_query
setting inside the
passdb
filter:
doveconf
passdb
sql
passdb_sql_query
SELECT ...
passdb
sql
sql_query
SELECT ...
passdb
sql
query
SELECT ...
passdb
sql2
# This will NOT work, as it expands to nonexistent passdb_sql2_query:
#query = SELECT ...
Plugin settings
The
plugin { ... }
section no longer exists. Plugin settings are global the same as all other settings.
Config $variables
Using
$setting
variables in config files requires
$SET:
prefix now. For example
user = $default_internal_user
is now
user = $SET:default_internal_user
. See
variable expansion
for more details.
Note that earlier it was common to refer to the same setting, e.g.:
doveconf
mail_plugins
$mail_plugins quota
Most of this is now unnecessary, because of the new
boollist
setting type, which allows you to use:
doveconf
mail_plugins
quota
yes
Variable expansion
A new
Settings Variables
syntax has been introduced. All old one-letter %variables have been removed, and some old variable aliases have been dropped too.
The new syntax uses
character for "filters" which can be chained. This is why some of the old variables have been replaced by filters. For example the old
%d
variable is now
%{user | domain}
, which gets the "user" variable and applies the "domain" filter for it.
List of common short variables and their replacements.
Old variable
New syntax
%a
%{local_port}
%b
%{remote_port}
%c
%{secured}
%d
%{user | domain}
%h
%{home}
%l
%{local_ip}
%m
%{mechanism}
%n
%{user | username}
%p
%{client_pid}
%r
%{remote_ip}
%s
%{protocol}
for login & auth settings,
%{service}
for storage settings
%u
%{user}
%w
%{password}
Common modifier syntaxes and their replacements.
Old syntax
New syntax
%1Mu
%{user | md5 | hexlify(1)}
%2.1Mu
%{user | md5 | hexlify | substr(2,1)}
%2.256N
%{user | md5 | substr(0, 8) % 256 | hex(2)}
%256Nu
%{user | md5 | substr(0, 8) % 256 | hex}
%Hu
No conversion available, use one of the syntaxes.
%Ln
%{user | username | lower}
%Lu
%{user | lower}
%Mu
%{user | md5}
Common long variables and their replacements.
Old variable
New syntax
%{auth_domain}
%{auth_user | domain}
%{auth_username}
%{auth_user | username}
%{lip}
%{local_ip}
%{lport}
%{local_port}
%{mech}
%{mechanism}
%{orig_domain}
%{original_user | domain}
%{orig_username}
%{original_user | username}
%{orig_user}
%{original_user}
%{real_lip}
%{real_local_ip}
%{real_lport}
%{real_local_port}
%{real_rip}
%{real_remote_ip}
%{real_rport}
%{real_remote_port}
%{rip}
%{remote_ip}
%{rport}
%{remote_port}
%{service}
for login & auth settings (but not storage settings)
%{protocol}
Shared namespace variables
Previously
%%u
%%n
and
%%d
could be used in shared namespace configuration.
These were changed for the
namespace_prefix
Old variable
New syntax
%%u
$user
%%n
$username
%%d
$domain
For other settings, such as
mail_path
Old variable
New syntax
%%u
%{owner_user}
%%n
%{owner_user | username}
%%d
%{owner_user | domain}
%%h
%{owner_home}
Directory Hashing
If you have been using
/home/%2.256N/%u
or similar constructs:
How to replace
%N
in new format:
%2.256Nu
becomes
%{user | md5 | substr(0, 8) % 256 | hex(2)}
to return maximum 256 different hashes in range
00..ff
%256Nu
becomes
%{user | md5 | substr(0, 8) % 256 | hex}
to return maximum 256 different hashes in range
0..ff
(without 0-padding in the front).
How to replace
%M
in new format:
%1Mu/%2.1Mu/%u
becomes
%{user | md5 | hexlify(1)}/%{user | md5 | hexlify | substr(2,1)}/%{user}
to returns directories from
0/0/user
to
f/f/user
There is no way to use
%H
anymore.
Unknown/Invalid Variables
Unknown/invalid
%{variables}
cause Dovecot errors. This may cause, e.g., authentication failures if the old (broken) behavior was relied on.
passdb/userdb Section Naming
passdb
and
userdb
sections now require a name, i.e.:
doveconf
# This gives an error:
passdb
...
# Use this instead:
passdb
some_name
Empty userdb Variables
userdb fields can be set to empty value. Previously they became changed to
yes
value.
Added Features
Auth Policy Parameters
See
Authentication Policy
Parameter
Notes
%{fail_type}
variable to
auth_policy_request_attributes
Variable was added.
Cryptographic Features
Feature
Notes
ARGON2 password scheme
Support for the ARGON2 password scheme was added.
SCRAM-SHA-1, SCRAM-SHA-256
Support SASL mechanisms for outgoing connections.
X25519, X448
mail-crypt plugin
and
Mail Crypt Plugin: fs-crypt
now support these curves.
imapc_features Parameters
See
imapc_features
Feature
Notes
no-qresync
Parameter was added.
Settings
auth_internal_failure_delay
fts_message_max_size
login_socket_path
quota_mailbox_count
quota_mailbox_message_count
submission_add_received_header
cassandra_log_retries
Deprecated Features
Feature
Notes
acl_global_path
Using ACL file is deprecated, see
ACL Settings Migration
fs-sis
Saving new mails' attachments via fs-sis is disabled, but reading SIS attachments is still supported. Missing SIS attachments are replaced with files filled with spaces.
Removed Features
Feature
Notes
fts-lucene, fts-squat
Use
fts-flatcurve plugin
or
fts-solr plugin
dsync: Remove -D parameter
Parameter for disabling mailbox rename syncing removed. It hasn't been necessary for a long time, and it is broken.
dsync
Use
doveadm sync
instead.
dsync
has been a symlink to
doveadm
already, this release removed the symlink completely.
director
Support for the Dovecot Director architecture has been removed. For a small-scale, unsupported replacement, see
Lua Director
replicator
Use
NFS
or some other shared filesystem instead.
Dovecot director role
Replaced with the
Dovecot Pro Palomar architecture
Global ACL directory
Use
acl
instead. See
below
for details on migration.
IMAP SETQUOTA command
Quota limits can no longer be modified using the IMAP SETQUOTA command. The
set_quota
setting has been removed.
IPC process
Has been merged to anvil.
OpenSSL support for older than 1.0.2
Older versions are not supported anymore.
Sieve extensions:
notify
imapflags
vnd.dovecot.duplicate
These deprecated Sieve extensions have been removed.
ssl-parameters.dat
This file is no longer converted automatically by config process, you need to set
ssl_server_dh_file
setting if you need non-ECC Diffie-Hellman.
TCP wrapper support
Use
Lua authentication database
instead.
Weak password schemes
Weak password schemes are disabled by default; you need to use
auth_allow_weak_schemes
to enable them.
local_name "multiple names" { ... }
List each name as a separate
local_name { ... }
Cassandra Parameters
See
Cassandra configuration
Parameter
Notes
Cassandra
ssl_verify=cert-dns
setting
Removed, as it was deprecated by Cassandra cpp-driver due to it being insecure against MITM attacks.
Backends and Plugins
Backend
Notes
checkpassword auth database
Use
Lua authentication database
instead.
Dict passdb & userdb driver
Use
Lua authentication database
instead.
Dict quota; Dirsize quota
These drivers are removed. You should use
Quota Driver: Count
instead along with
quota-clone plugin
Note that switching to quota count can cause all users' indexes to update, so reserve time for this.
imap-zlib plugin
The IMAP
COMPRESS
extension is now automatically enabled.
listescape plugin
Use
mailbox_list_storage_escape_char
instead.
mailbox-alias plugin
Depending on the use case, replacement may be the
mailbox_special_use
mailbox setting and/or
Sieve
filters.
Memcached dict driver
Use
Redis
instead.
old-stats plugin
Use
Statistics
instead.
auth_stats
setting has been removed too.
shadow auth driver
Use
PAM authentication database
instead.
XZ Compression
You need to perform migration using a different compression format. With
Maildir
, you can try uncompressing all your mail and compressing them with another algorithm while Dovecot is not running.
zlib plugin
Use
mail-compress plugin
with the
mail_compress_write_method
setting instead.
Settings
Setting
Notes
auth_stats
dict_db_config
Berkeley DB is not supported anymore.
imap_id_log
Replaced by the
imap_id_received
event.
login_access_sockets
Use
Lua authentication database
instead. Dovecot will fail to start if this setting is present in configuration.
quota_set
sieve_dir
See
Script storage
sieve_global_dir
See
Script storage
sieve_global_path
See
Script storage
sieve_editheader_protected
Replaced by
sieve_editheader_header_forbid_add
and
sieve_editheader_header_forbid_delete
sieve_vacation_max_subject_codepoints
Changed Features
Settings
Setting
Notes
ssl
Connections from
login_trusted_networks
are now also required to be SSL/TLS encrypted with the setting
ssl=required
ssl_min_protocol
The
SSLv3
option was removed, as it is no longer secure.
Converted Settings
Setting
Notes
acl
Replaced by
acl_driver
acl_anyone
Renamed to
imap_acl_allow_anyone
auth_debug
Use
log_debug
filter instead. Example:
log_debug=category=auth
auth_default_realm
Replaced by
auth_default_domain
auth_policy_server_timeout_msecs
Replaced by
http_client_request_timeout
inside
auth_policy
named filter.
auth_worker_max_count
Use
service-specific process limit
default_idle_kill
Renamed to
default_idle_kill_interval
disable_plaintext_auth
Replaced by
auth_allow_cleartext
doveadm_http_rawlog_dir
Replaced by
http_client_rawlog_dir
inside
doveadm_server
named filter.
event_exporter_format_args
Replaced by
event_exporter_time_format
event_exporter_transport
Renamed to
event_exporter_driver
event_exporter_transport_args
Split off to driver-specific settings, see
Event Export
event_exporter_transport_timeout
Replaced by
http_client_request_timeout
and
event_exporter_unix_connect_timeout
imap_capability = +CAPA1
Use
imap_capability
{ CAPA1 = yes }
instead.
inet_listener { address }
Replaced by
listen
setting.
push_notification_backend
Use
push_notification_driver
instead.
mail_crypt_require_encrypted_user_key
Replaced by
crypt_user_key_require_encrypted
crypt_user_key_password
and
crypt_user_key_encryption_key
verbose_ssl
Use
log_debug = category=ssl
instead.
mail_attachment_dir
Renamed to
mail_ext_attachment_path
mail_attachment_fs
Use
fs
inside
mail_ext_attachment
named filter.
mail_attachment_hash
Renamed to
mail_ext_attachment_hash
mail_attachment_min_size
Renamed to
mail_ext_attachment_min_size
mail_attribute_dict
Use
dict
inside
mail_attribute
named filter.
mail_location
setting &
mail
userdb field
Split into multiple
mail_*
settings.
namespace { location }
setting
Use
mail_*
settings inside
namespace
named list filter.
notify_status_dict
Use
dict
inside
notify_status
named filter.
notify_status_mailbox
Use
mailbox_notify_status
inside
mailbox
named list filters.
fts
Replaced by
fts
named filter.
fts_autoindex_exclude
Replaced by boolean property
fts_autoindex
, nested inside
mailbox
blocks. Note that the values are inverted as compared to those in the old
fts_autoindex_exclude
fts_decoder
Replaced by
fts_decoder_driver
and
fts_decoder_script_socket_path
fts_enforced
Replaced by
fts_search_add_missing
and
fts_search_read_fallback
fts_index_timeout
Renamed to
fts_search_timeout
. The default value is set to
30 secs
fts_solr
Replaced by
fts_solr_url
fts_solr_batch_size
fts_solr_soft_commit
, and
http_client_rawlog_dir
settings.
fts_tika
Replaced by
fts_decoder_driver
and
fts_decoder_tika_url
fts_language_config
Renamed to
textcat_config_path
fts_languages
Converted into
language
blocks.
fts_filters
Split into
language_filters
language_filter_normalizer_icu_id
language_filter_stopwords_dir
fts_tokenizers
Split into
language_tokenizers
language_tokenizer_address_token_maxlen
language_tokenizer_generic_algorithm
language_tokenizer_generic_token_maxlen
language_tokenizer_generic_wb5a
language_tokenizer_kuromoji_icu_id
language_tokenizer_kuromoji_split_compounds
language_tokenizer_kuromoji_token_maxlen
lazy_expunge
Renamed to
lazy_expunge_mailbox
service { idle_kill }
Renamed to
service_idle_kill_interval
service { service_count }
Renamed to
service_restart_request_count
. The default value is set to
unlimited
. Value
is now a configuration error.
oauth2
username_format
Renamed to
oauth2_username_validation_format
oauth2
pass_attrs
Replaced by
oauth2_fields
oauth2
local_validation_key_dict
Replaced by
dict
inside
oauth2_local_validation
named filter.
oauth2
timeout_msecs
max_idle_time_msecs
max_parallel_connections
max_pipelined_requests
rawlog_dir
Replaced by
http_client_*
settings inside
oauth2
named filter.
oauth2
tls_*
Replaced by
ssl_client_*
settings inside
oauth2
named filter.
oauth2
debug
Use
log_debug
filter instead. Example:
log_debug=category=oauth2
oauth
use_grant_password
Replaced by
passdb oauth2
passdb/userdb
:protected
Renamed to
:default
passdb { default_fields
override_fields
Replaced by
passdb_fields
userdb { default_fields
override_fields
Replaced by
userdb_fields
plugin
All plugin settings are now global settings.
quota
quota_rule
Split into separate
quota settings
quota_grace
Renamed to
quota_storage_grace
quota_over_flag
Renamed to
quota_over_status_current
quota_over_flag_lazy_check
Renamed to
quota_over_status_lazy_check
quota_over_flag_value
Renamed to
quota_over_status_mask
quota_over_script
Replaced by
quota_over_status
named filter with
execute
quota_max_mail_size
Renamed to
quota_mail_size
. The default value is set to
unlimited
sieve
Replaced by
storage settings
inside
sieve_script
filter.
sieve_after
Replaced by
sieve_script_type = after
for
sieve_script
filter.
sieve_default
Replaced by
sieve_script_type = default
for
sieve_script
filter.
sieve_default_name
Replaced by
sieve_script_name
sieve_discard
Replaced by
sieve_script_type = discard
for
sieve_script
filter.
sieve_global
Replaced by
sieve_script_type = global
for
sieve_script
filter.
sieve_quota_max_scripts
Renamed to
sieve_quota_script_count
sieve_quota_max_storage
Renamed to
sieve_quota_storage_size
sieve_user_log
Renamed to
sieve_user_log_path
sieve_editheader_forbid_add
Renamed to
sieve_editheader_header_forbid_add
sieve_editheader_forbid_delete
Renamed to
sieve_editheader_header_forbid_delete
sieve_spamtest_max_header
Renamed to
sieve_spamtest_score_max_header
sieve_spamtest_max_value
Renamed to
sieve_spamtest_score_max_value
sieve_spamtest_text_value
Changed
sieve_spamtest_text_value
into string list.
sieve_vacation_dont_check_recipient
replaced by
sieve_vacation_check_recipient
sieve_variables_max_scope_size
Renamed to
sieve_variables_max_scope_count
sieve_variables_max_variable_size
Renamed to
sieve_variables_max_value_size
sieve_virustest_max_header
Renamed to
sieve_virustest_score_max_header
sieve_virustest_max_value
Renamed to
sieve_virustest_score_max_value
sieve_virustest_text_value
Changed
sieve_virustest_text_value
into string list.
imapsieve_mailbox*
See
imap-sieve plugin
ssl_alt_cert
Renamed to
ssl_server_alt_cert_file
ssl_alt_key
Renamed to
ssl_server_alt_key_file
ssl_ca
Split to
ssl_server_ca_file
and
ssl_client_ca_file
ssl_ca_dir
Renamed to
ssl_client_ca_dir
ssl_ca_file
Renamed to
ssl_client_ca_file
ssl_cert
Renamed to
ssl_server_cert_file
ssl_cert_username_field
Renamed to
ssl_server_cert_username_field
ssl_client_cert
Renamed to
ssl_client_cert_file
ssl_client_key
Renamed to
ssl_client_key_file
ssl_dh
Renamed to
ssl_server_dh_file
ssl_key
Renamed to
ssl_server_key_file
ssl_key_password
Renamed to
ssl_server_key_password
ssl_prefer_server_ciphers
Replaced by
ssl_server_prefer_ciphers
ssl_require_crl
Renamed to
ssl_server_require_crl
ssl_verify_client_cert
Renamed to
ssl_server_request_client_cert
stats_http_rawlog_dir
Replaced by
http_client_rawlog_dir
inside
stats_server
named filter.
External Configuration Files
v2.3 configured sql, ldap and some other features using
.conf.ext
external configuration files. These have been replaced by regular settings, which can be used in the same place where they used to be referred to before. For example:
dovecot-2.3.conf
dovecot-2.3-sql.conf.ext
dovecot-new.conf
passdb {
driver = mysql
args = /etc/dovecot/dovecot-sql.conf.ext
connect = host=127.0.0.1 user=mysql_user pass=mysql_pass
password_query = SELECT password FROM users WHERE user = '%u'
# Use these mysql settings globally. These could be also inside passdb sql {}
mysql 127.0.0.1 {
user = mysql_user
password = mysql_pass
sql_driver = mysql
passdb sql {
query = SELECT password FROM users WHERE user = '%{user}'
SQL authentication database
LDAP authentication
OAuth2 Authentication Database
Default Settings
Setting
Old Default
New Default
Notes
imapc_features
Features "delay-login", "search", "fetch-headers", "fetch-bodystructure", "fetch-size" by default. Enable "acl" and "modseq" by default, if the remote server supports it.
mail_cache_max_headers_count
unlimited
100
New feature, explicitly set to
for the old behavior.
mail_cache_max_header_name_length
unlimited
100
New feature, explicitly set to
for the old behavior.
mail_log_prefix
%s(%u)<%{pid}><%{session}>:
%{service}(%{user})<%{process:pid}><%{session}>:
New variable expansion syntax.
mailbox_list_drop_noselect
no
yes
\NoSelect
folders are now dropped by default.
service/anvil/chroot
empty

Anvil is no longer chrooted.
service/anvil/user
$default_internal_user

Anvil runs as root.
service/auth-worker/process_limit
30
protocols
imap pop3 lmtp
No protocols are enabled by default.
fs-crypt
Mail Crypt Plugin: fs-crypt
now requires encryption keys by default.
Changed types for FTS header settings
Setting Name
Update
fts_header_excludes
Changed to
Boolean List
fts_header_includes
Changed to
Boolean List
Service defaults
LMTP
Default LMTP proxy destination port is now
24
Event Changes
Core Events
Event
Change
fts_flatcurve_expunge
This event was added.
fts_flatcurve_index
This event was added.
fts_flatcurve_last_uid
This event was added.
fts_flatcurve_optimize
This event was added.
fts_flatcurve_query
This event was added.
fts_flatcurve_rescan
This event was added.
fts_flatcurve_rotate
This event was added.
auth_client_cache_flush_started
Event was removed.
auth_client_cache_flush_finished
Event was removed.
imap_id_received
Event was added.
login_aborted
Event was added.
mail_metadata_accessed
Event was added.
pop3_command_finished
Event was added.
Event Fields
Event
Field
Change
dns_worker_request_finished
cached
Field was added.
Mail user events
service
Field was added.
proxy_session_finished
error_code
Field was added.
proxy_session_finished
idle_usecs
Field was changed from
idle_secs
smtp_server_transaction_rcpt_finished
dest_host
Field was added.
smtp_server_transaction_rcpt_finished
dest_ip
Field was added.
sql_query_finished
consistency
Field was added.
sql_query_finished
error_consistency
Field was added.
Various
net_bytes_in
Field was changed from
bytes_in
Various
net_bytes_out
Field was changed from
bytes_out
Various
transport
transport=trusted
was changed to
transport=secured
. See also
secured connections
Event Filters
Size units are allowed when specifying event filter values. For example,
100kb
is accepted as equivalent to
102400
Interval units are allowed when specifying event filter values. For example,
1min
is accepted as equivalent to
60000000
Event filters support escaping wildcard
and
characters by prefixing them with
Exports
Events can now be exported to a local file or a unix socket. See
Event Export: Drivers
ACLs
Use ACL settings instead of Global ACL Directories or Global ACL File
With the following starting configuration:
dovecot.conf
/etc/dovecot/acls/INBOX
/etc/dovecot/acls/INBOX/foo/.DEFAULT
/etc/dovecot/acls/INBOX/foo/bar
doveconf
namespace
inbox
prefix
INBOX/
separator
plugin
acl
vfile:/etc/dovecot/acls/
owner lrwstipekxa
anyone lr
user=kim l
user=timo lr
user=kim lrw
user=kim lrw
Or the same ACLs in a global ACL file:
INBOX owner lrwstipekxa
INBOX anyone lr
INBOX user=kim l
INBOX/foo user=timo lr
INBOX/foo user=kim lrw
INBOX/foo/bar user=kim lrw
You have to create the new ACLs to
dovecot.conf
doveconf
namespace
inbox
# previously from /etc/dovecot/acls/INBOX
mailbox
INBOX
acl
owner
rights
lrwstipekxa
acl
anyone
rights
lr
acl user=kim {
rights
# previously from /etc/dovecot/acls/foo/.DEFAULT
mailbox
INBOX/foo
acl user=timo {
rights
lr
acl user=kim {
rights
lrw
# previously from /etc/dovecot/acls/foo/bar
mailbox
INBOX/foo/bar
acl user=kim {
rights
lrw
Note that at this point you could simplify specific rules, e.g. use mailbox name wildcards to replace lines for a specific user:
doveconf
mailbox INBOX/* {
acl user=kim {
rights
lrw
And re-configure the ACL plugin:
doveconf
acl_driver
vfile
acl_globals_only
yes
Afterwards you can remove the old global ACL directory parent:
sh
rm
-rf
/etc/dovecot/acls/
Lua HTTP API
Some settings were renamed. See
lib-lua: HTTP Functions
. The
debug
setting was removed - use
log_debug
instead to enable debugging.
Lua Authentication
Lua passdb/userdb now passes all args key/values to an initialization function. See
Lua authentication initialization
Variable expansion
changes affect also
auth_request
fields. For example
auth_request.service
is now
auth_request.protocol
Doveadm
doveadm batch
The
doveadm batch
command was removed.
doveadm fs
doveadm fs put
can now put metadata also.
doveadm indexer
Added
doveadm indexer
command.
doveadm save
Added
-r received-date
parameter. See
doveadm save
dsync
The
dsync
command symlink was removed. Use
doveadm sync
or
doveadm backup
commands directly instead.
Mailbox Commands
USER
environment variable can be used only with
--no-userdb-lookup
parameter.
All mail commands require providing
-u
-F
-A
parameter or
--no-userdb-lookup
parameter. This will always be subject to user database lookup and requires access to auth userdb socket, unless
--no-userdb-lookup
was used.
LDA
environment is no longer used. (It was previously used when
-d
parameter was not given.) You can now use it by explicitly giving
-o mail_home=$HOME
parameter.
Exim Authentication
Dovecot authentication protocol changed slightly, which is now causing Exim's Dovecot authentication to hang. Use the
auth-legacy
listener type to work around it until Exim supports the updated protocol:
dovecot.conf
exim.conf
doveconf
service
auth
unix_listener
auth-exim
type
auth-legacy
dovecot_plain:
server_socket = /var/run/dovecot/auth-exim
...
Doveadm HTTP API
Boolean Request Values
The doveadm HTTP API now requires valid boolean values. Providing invalid boolean values will result in a 400 response.
Upgrade Tips
Mailbox Location
WARNING
These are examples of some common conversions. You MUST adjust the specific examples to your own environment.
diff
-mail_home = /home/vmail/%u
+mail_home = /home/vmail/%{user}
diff
-mail_home = /home/vmail/%d/%u
+mail_home = /home/vmail/%{user|domain}/%{user|username} # or some variant of this.
diff
-mail_location = maildir:~/
+mail_path = ~/
+mail_driver = maildir
diff
-mail_location = maildir:/var/srv/foo/%d/%u
+mail_path = /var/srv/foo/%{user|domain}/%{user|username}
+mail_driver = maildir
In addition you might want to convert:
diff
-INDEX=~/.index
+mail_index_path=~/.index
diff
-CONTROL=~/.control
+mail_control_path=~/.control
diff
-LAYOUT=fs
+mailbox_list_layout=fs
A minimal working config is:
doveconf
mail_home
/home/vmail/%{user}
mail_driver
maildir
mail_path
~/maildir
mail_uid
vmail
mail_gid
vmail
Namespace
diff
namespace other {
- location = maildir:/foo/bar
+ mail_path = /foo/bar
+ # optional, if this is matches your top level
+ mail_driver = maildir