Dovecot Pro
Search K

Appearance

Note: This is pre-release documentation.
Please access https://doc.dovecotpro.com/latest/ for documentation on released versions.

Upgrading from OX Dovecot Pro 2.3.x to Dovecot Pro 3.1.x ​

INFO

This page is intended as a summarization of the tasks necessary to move from the deprecated OX Dovecot Pro 2.3.x releases to Dovecot Pro 3.1.x.

It combines and summarizes these two pages:

Those two pages remain the canonical source for the upgrade instructions to 3.0.x and 3.1.x. Refer to those pages for further details on changes for each major version.

Dovecot Pro ​

Product Changes ​

  • The Director architecture has been deprecated and removed. Dovecot Pro 3.x only supports the new Dovecot Pro Palomar architecture.
  • AWS S3 Storage no longer can use object listings. Instead, Dictmap must be used.
  • sdbox and mdbox are no longer supported for NFS installations. Dovecot Pro 3.x only supports the obox mailbox format. Dovecot Pro 2.3.x NFS/dbox installations MUST migrate users to obox for 3.x.

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:

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.:

mail_plugins = $mail_plugins quota

Most of this is now unnecessary, because of the new boollist setting type, which allows you to use:

mail_plugins {
  quota = yes
}

passdb/userdb Section Naming ​

Passdb and userdb sections now require a name, i.e.:

# This gives an error:
passdb {
  ...
}

# Use this instead:
passdb some_name {
}

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 variableNew 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 syntaxNew 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}
%HuNo conversion available, use one of the syntaxes.
%Ln%{user | username | lower}
%Lu%{user | lower}
%Mu%{user | md5}
Common long variables and their replacements. ​
Old variableNew 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 variableNew syntax
%%u$user
%%n$username
%%d$domain

For other settings, such as mail_path:

Old variableNew syntax
%%u%{owner_user}
%%n%{owner_user | username}
%%d%{owner_user | domain}
%%h%{owner_home}

Unknown/Invalid Variables ​

Unknown/invalid %{variables} cause Dovecot errors. This may cause, e.g., authentication failures if the old (broken) behavior was relied on.

Empty userdb Variables ​

userdb fields can be set to empty value. Previously they became changed to yes value.

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.

Added Features ​

Auth Policy Parameters ​

See Authentication Policy.

ParameterNotes
%{fail_type} variable to auth_policy_request_attributesVariable was added.

Cryptographic Features ​

FeatureNotes
ARGON2 password schemeSupport for the ARGON2 password scheme was added.
SCRAM-SHA-1, SCRAM-SHA-256Support SASL mechanisms for outgoing connections.
X25519, X448mail-crypt plugin and Mail Crypt Plugin: fs-crypt now support these curves.

imapc_features Parameters ​

See imapc_features.

FeatureNotes
no-qresyncParameter was added.

LDAP Parameters ​

See LDAP authentication.

FeatureNotes
%{ldap_multi} variableVariable was added to LDAP configuration file to allow for fetching a multi-valued attribute.

base64url Hash Modifier ​

Added base64url format to hash modifier in variable expansion. Example: %{sha1;format=base64url:username}. See Variable Modifiers.

Cassandra Parameters ​

See Cassandra configuration.

ParameterNotes
log_retriesParameter was added.

Settings ​

Changed Features ​

Settings ​

SettingNotes
sslConnections from login_trusted_networks are now also required to be SSL/TLS encrypted with the setting ssl=required.
ssl_min_protocolThe SSLv3 option was removed, as it is no longer secure.

fs-crypt ​

Mail Crypt Plugin: fs-crypt now requires encryption keys by default.

Default Settings ​

SettingOld DefaultNew DefaultNotes
mail_prefetch_count for obox010
mail_fsync for oboxoptimizednever
mail_sort_max_read_count for obox0100
mail_cache_fieldsflagsflags hdr.date hdr.subject hdr.from hdr.sender hdr.reply-to hdr.to hdr.cc hdr.bcc hdr.in-reply-to hdr.message-id date.received size.virtual imap.bodystructure mime.parts hdr.references hdr.importance hdr.x-priority hdr.x-open-xchange-share-url pop3.uidl pop3.order
mail_always_cache_fieldsflags hdr.date hdr.subject hdr.from hdr.sender hdr.reply-to hdr.to hdr.cc hdr.bcc hdr.in-reply-to hdr.message-id date.received size.virtual imap.bodystructure mime.parts hdr.references hdr.importance hdr.x-priority hdr.x-open-xchange-share-url pop3.uidl pop3.order
mail_uidvmail
mail_gidvmail
mail_temp_dir/tmp/dev/shm/dovecot
verbose_proctitlenoyes
import_environment { MALLOC_MMAP_THRESHOLD_ }131072
fts_dovecot_mail_flush_interval010
fts_dovecot_max_triplets0200
imapc_featuresFeatures "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_countunlimited100New feature, explicitly set to 0 for the old behavior.
mail_cache_max_header_name_lengthunlimited100New feature, explicitly set to 0 for the old behavior.
mail_log_prefix%s(%u)<%{pid}><%{session}>:%s(%u)<%{process:pid}><%{session}>:Uses new process key.
mailbox_list_drop_noselectnoyes\NoSelect folders are now dropped by default.
service/anvil/chrootempty<no value>Anvil is no longer chrooted.
service/anvil/user$default_internal_user<no value>Anvil runs as root.
service/auth-worker/process_limit130
mail_log_prefix%s(%u)<%{process:pid}><%{session}>:%{service}(%{user})<%{process:pid}><%{session}>:New variable expansion syntax
mailbox_list_drop_noselectnoyes\NoSelect folders are now dropped by default.
protocolsimap pop3 lmtpNo protocols are enabled by default.
lmtp_user_concurrency_limitunlimited10The previous conflation of 0 and unlimited is removed, 0 is now an illegal value.

Converted Settings ​

SettingNotes
aclReplaced by acl_driver.
acl_anyoneRenamed to imap_acl_allow_anyone.
auth_debugUse log_debug filter instead. Example: log_debug=category=auth.
auth_default_realmReplaced by auth_default_domain.
auth_policy_server_timeout_msecsReplaced by http_client_request_timeout inside auth_policy named filter.
auth_worker_max_countUse service-specific process limit.
default_idle_killRenamed to default_idle_kill_interval.
disable_plaintext_authReplaced by auth_allow_cleartext.
doveadm_http_rawlog_dirReplaced by http_client_rawlog_dir inside doveadm_server named filter.
event_exporter_format_argsReplaced by event_exporter_time_format.
event_exporter_transportRenamed to event_exporter_driver.
event_exporter_transport_argsSplit off to driver-specific settings, see Event Export.
event_exporter_transport_timeoutReplaced by http_client_request_timeout and event_exporter_unix_connect_timeout.
imap_capability = +CAPA1Use imap_capability { CAPA1 = yes } instead.
inet_listener { address }Replaced by listen setting.
push_notification_backendUse push_notification_driver instead.
mail_crypt_require_encrypted_user_keyReplaced by crypt_user_key_require_encrypted, crypt_user_key_password and crypt_user_key_encryption_key.
verbose_sslUse log_debug = category=ssl instead.
mail_attachment_dirRenamed to mail_ext_attachment_path.
mail_attachment_fsUse fs inside mail_ext_attachment named filter.
mail_attachment_hashRenamed to mail_ext_attachment_hash.
mail_attachment_min_sizeRenamed to mail_ext_attachment_min_size.
mail_attribute_dictUse dict inside mail_attribute named filter.
mail_location setting & mail userdb fieldSplit into multiple mail_* settings.
namespace { location } settingUse mail_* settings inside namespace named list filter.
notify_status_dictUse dict inside notify_status named filter.
notify_status_mailboxUse mailbox_notify_status inside mailbox named list filters.
ftsReplaced by fts named filter.
fts_autoindex_excludeReplaced 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_decoderReplaced by fts_decoder_driver and fts_decoder_script_socket_path.
fts_enforcedReplaced by fts_search_add_missing and fts_search_read_fallback.
fts_index_timeoutRenamed to fts_search_timeout. The default value is set to 30 secs.
fts_solrReplaced by fts_solr_url, fts_solr_batch_size, fts_solr_soft_commit, and http_client_rawlog_dir settings.
fts_tikaReplaced by fts_decoder_driver and fts_decoder_tika_url.
fts_language_configRenamed to textcat_config_path.
fts_languagesConverted into language blocks.
fts_filtersSplit into language_filters, language_filter_normalizer_icu_id, language_filter_stopwords_dir.
fts_tokenizersSplit 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_expungeRenamed 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 0 is now a configuration error.
oauth2 username_formatRenamed to oauth2_username_validation_format.
oauth2 pass_attrsReplaced by oauth2_fields.
oauth2 local_validation_key_dictReplaced by dict inside oauth2_local_validation named filter.
oauth2 timeout_msecs, max_idle_time_msecs, max_parallel_connections, max_pipelined_requests, rawlog_dirReplaced by http_client_* settings inside oauth2 named filter.
oauth2 tls_*Replaced by ssl_client_* settings inside oauth2 named filter.
oauth2 debugUse log_debug filter instead. Example: log_debug=category=oauth2.
oauth use_grant_passwordReplaced by passdb oauth2.
passdb/userdb :protectedRenamed to :default.
passdb { default_fields, override_fields }Replaced by passdb_fields.
userdb { default_fields, override_fields }Replaced by userdb_fields.
pluginAll plugin settings are now global settings.
quota, quota_ruleSplit into separate quota settings.
quota_graceRenamed to quota_storage_grace.
quota_over_flagRenamed to quota_over_status_current.
quota_over_flag_lazy_checkRenamed to quota_over_status_lazy_check.
quota_over_flag_valueRenamed to quota_over_status_mask.
quota_over_scriptReplaced by quota_over_status named filter with execute.
quota_max_mail_sizeRenamed to quota_mail_size. The default value is set to unlimited.
sieveReplaced by storage settings inside sieve_script filter.
sieve_afterReplaced by sieve_script_type = after for sieve_script filter.
sieve_defaultReplaced by sieve_script_type = default for sieve_script filter.
sieve_default_nameReplaced by sieve_script_name.
sieve_discardReplaced by sieve_script_type = discard for sieve_script filter.
sieve_globalReplaced by sieve_script_type = global for sieve_script filter.
sieve_quota_max_scriptsRenamed to sieve_quota_script_count.
sieve_quota_max_storageRenamed to sieve_quota_storage_size.
sieve_user_logRenamed to sieve_user_log_path.
sieve_editheader_forbid_addRenamed to sieve_editheader_header_forbid_add.
sieve_editheader_forbid_deleteRenamed to sieve_editheader_header_forbid_delete.
sieve_spamtest_max_headerRenamed to sieve_spamtest_score_max_header.
sieve_spamtest_max_valueRenamed to sieve_spamtest_score_max_value.
sieve_spamtest_text_value<X>Changed sieve_spamtest_text_value into string list.
sieve_vacation_dont_check_recipientreplaced by sieve_vacation_check_recipient.
sieve_variables_max_scope_sizeRenamed to sieve_variables_max_scope_count.
sieve_variables_max_variable_sizeRenamed to sieve_variables_max_value_size.
sieve_virustest_max_headerRenamed to sieve_virustest_score_max_header.
sieve_virustest_max_valueRenamed to sieve_virustest_score_max_value.
sieve_virustest_text_value<X>Changed sieve_virustest_text_value into string list.
imapsieve_mailbox*See imap-sieve plugin.
ssl_alt_certRenamed to ssl_server_alt_cert_file.
ssl_alt_keyRenamed to ssl_server_alt_key_file.
ssl_caSplit to ssl_server_ca_file and ssl_client_ca_file.
ssl_ca_dirRenamed to ssl_client_ca_dir.
ssl_ca_fileRenamed to ssl_client_ca_file.
ssl_certRenamed to ssl_server_cert_file.
ssl_cert_username_fieldRenamed to ssl_server_cert_username_field.
ssl_client_certRenamed to ssl_client_cert_file.
ssl_client_keyRenamed to ssl_client_key_file.
ssl_dhRenamed to ssl_server_dh_file.
ssl_keyRenamed to ssl_server_key_file.
ssl_key_passwordRenamed to ssl_server_key_password.
ssl_prefer_server_ciphersReplaced by ssl_server_prefer_ciphers.
ssl_require_crlRenamed to ssl_server_require_crl.
ssl_verify_client_certRenamed to ssl_server_request_client_cert.
stats_http_rawlog_dirReplaced 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:

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
  pass = mysql_pass
}
sql_driver = mysql

passdb sql {
  query = SELECT password FROM users WHERE user = '%{user}'
}

Renamed Settings ​

Old SettingNew Setting
metacache_disable_bundle_list_cachemetacache_bundle_list_cache
metacache_disable_secondary_indexesmetacache_secondary_indexes
obox_refresh_index_once_aftermetacache_refresh_index_once_after
obox_rescan_mails_once_aftermetacache_rescan_mails_once_after
obox_no_pop3_backend_uidlsobox_pop3_backend_uidls
obox_dont_use_object_idsobox_use_object_ids

Service Settings ​

The default service settings have been changed:

IMAP Hibernation ​

IMAP Hibernation is now enabled by default.

metacache UNIX socket listener ​

New default:

service metacache {
  unix_listener metacache {
    mode = 0660
    group = $default_internal_group
  }
}
LMTP ​

Default LMTP proxy destination port is now 24.

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 ​

Variable expansion changes affect also auth_request fields. For example auth_request.service is now auth_request.protocol.

Shared Mailboxes ​

If you had SQL or Cassandra based acl_sharing_map, the performance wasn't optimal. A new acl_dict_index setting was added to improve this, which is enabled by default, and needs changes. First, add a new index to SQL/CQL:

sql
CREATE INDEX user_shares_from_user
  ON user_shares (from_user); -- because we search for from_user when rebuilding ACLs

And add a new dict_map for the indexed reverse lookups:

dict_server {
  dict acl {
    #dict_map shared/shared-boxes/user/$to/$from {
    # ...
    #}

    dict_map shared/shared-user-boxes-rev/$from/$to {
      sql_table = user_shares
      value_field dummy {
      }

      key_field from_user {
       value = $from
      }
      key_field to_user {
        value = $to
      }
    }
  }
}

Use ACL settings instead of Global ACL Directories or Global ACL File ​

With the following starting configuration:

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:

namespace inbox {
  # previously from /etc/dovecot/acls/INBOX
  mailbox INBOX {
    acl owner {
      rights = lrwstipekxa
    }
    acl anyone {
      rights = lr
    }
    acl user=kim {
      rights = l
    }
  }
  # 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:

mailbox INBOX/* {
  acl user=kim {
    rights = lrw
  }
}

And re-configure the ACL plugin:

acl_driver = vfile
acl_globals_only = yes

Afterwards you can remove the old global ACL directory parent:

sh
rm -rf /etc/dovecot/acls/

Removed Features ​

FeatureReplacement
License PluginPlugin has been removed and the license_checksum setting is marked obsolete.
Dovecot director roleReplaced with the Dovecot Pro Palomar architecture.
Global ACL directoryUse acl instead. See below for details on migration.
IMAP SETQUOTA commandQuota limits can no longer be modified using the IMAP SETQUOTA command. The set_quota setting has been removed.
IPC processHas been merged to anvil.
OpenSSL support for older than 1.0.2Older versions are not supported anymore.
Sieve extensions: notify, imapflags, vnd.dovecot.duplicateThese deprecated Sieve extensions have been removed.
ssl-parameters.datThis 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 supportUse Lua authentication database instead.
Weak password schemesWeak 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.

ParameterNotes
Cassandra ssl_verify=cert-dns settingRemoved, as it was deprecated by Cassandra cpp-driver due to it being insecure against MITM attacks.

Settings ​

SettingNotes
auth_stats
dict_db_configBerkeley DB is not supported anymore.
imap_id_logReplaced by the imap_id_received event.
login_access_socketsUse Lua authentication database instead. Dovecot will fail to start if this setting is present in configuration.
quota_set
sieve_dirSee Script storage.
sieve_global_dirSee Script storage.
sieve_global_pathSee Script storage.
sieve_editheader_protectedReplaced by sieve_editheader_header_forbid_add and sieve_editheader_header_forbid_delete.
sieve_vacation_max_subject_codepoints

Backends and Plugins ​

BackendNotes
checkpassword auth databaseUse Lua authentication database instead.
Dict passdb & userdb driverUse Lua authentication database instead.
Dict quota; Dirsize quotaThese 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 pluginThe IMAP COMPRESS extension is now automatically enabled.
listescape pluginUse mailbox_list_storage_escape_char instead.
mailbox-alias pluginDepending on the use case, replacement may be the mailbox_special_use mailbox setting and/or Sieve filters.
Memcached dict driverUse Redis instead.
old-stats pluginUse Statistics instead. auth_stats setting has been removed too.
shadow auth driverUse PAM authentication database instead.
XZ CompressionYou 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 pluginUse mail-compress plugin with the mail_compress_write_method setting instead.

Dictmap Settings ​

Dictmap configuration has been replaced by Dictmap: Settings.

ParameterDescription
cleanup-uncertainPreviously, this parameter needed to be explicitly enabled. It is now called fs_dictmap_cleanup_uncertain, which is enabled by default.
max-parallel-iterPreviously the default was 1. This parameter has been replaced by the fs_dictmap_max_parallel_iter, which defaults to 10. now.

Obox Parameters ​

See obox.

ParameterDescription
absolute_timeout_msecsUse absolute_timeout instead.
connect_timeout_msecsUse connect_timeout instead.
delete_timeout_msecsUse delete_timeout instead.
read_timeout_msecsUse read_timeout instead.
slow_warn_msecsUse slow_warn instead.
timeout_msecsUse timeout setting instead.
write_timeout_msecsUse write_timeout setting instead.

Event Changes ​

Events ​

EventChange
fs_object_write_uncertainEvent was added.
auth_client_cache_flush_startedEvent was removed.
auth_client_cache_flush_finishedEvent was removed.
imap_id_receivedEvent was added.
login_abortedEvent was added.
mail_metadata_accessedEvent was added.
pop3_command_finishedEvent was added.

Event Fields ​

EventFieldChange
dns_worker_request_finishedcachedField was added.
Mail user eventsserviceField was added.
proxy_session_finishederror_codeField was added.
proxy_session_finishedidle_usecsField was changed from idle_secs.
smtp_server_transaction_rcpt_finisheddest_hostField was added.
smtp_server_transaction_rcpt_finisheddest_ipField was added.
sql_query_finishedconsistencyField was added.
sql_query_finishederror_consistencyField was added.
Variousnet_bytes_inField was changed from bytes_in.
Variousnet_bytes_outField was changed from bytes_out.
Varioustransporttransport=trusted was changed to transport=secured. See also secured connections.

Exports ​

Events can now be exported to a local file or a unix socket. See Event Export: Drivers.

Use Global ACL Files instead of Global ACL Directories ​

To migrate the ACL directories into their respective files you have to do the following:

  1. Create a new consolidated global ACL file.
  2. For each subdirectory in the currently configured ACL directory, add a line starting with the mailbox name followed by the appropriate content.
  3. Change the vfile parameter to the new ACL file.
  4. Remove the old ACL directory parent.

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.

doveadm metacache pull ​

Added doveadm metacache pull command.

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.

Revision: c1a64f5

Last updated:

Copyright © Open-Xchange GmbH