doveadm - Man Page

Dovecot's administration utility


doveadm [-Dv] [-f formatter] command [command_options] [command_arguments]


doveadm is the Dovecot administration tool. It can be used to manage various parts of Dovecot, as well as access users' mailboxes.
Execute doveadm help, for a command usage listing.


Global doveadm(1) options:


Enables verbosity and debug messages.

-f formatter

Specifies the formatter for formatting the output. Supported formatters are:


prints each line with key=value pairs.


prints each keyvalue pair on its own line and separates records with form feed character (^L).


prints a table header followed by tab separated value lines.


prints a table header followed by adjusted value lines.

-o setting=value

Overrides the configuration setting from /etc/dovecot/dovecot.conf and from the userdb with the given value. In order to override multiple settings, the -o option may be specified multiple times.


Enables verbosity, including progress counter.


These commands work directly with Dovecot's master process.


doveadm reload

Force dovecot(1) to reload the configuration.


doveadm stop

Stop dovecot(1) and all its child processes.

Additional Master Commands

doveadm config

doveadm-config(1), Dump Dovecot configuration.

doveadm director

doveadm-director(1), Manage Dovecot directors (if used by proxy servers).

doveadm exec

doveadm-exec(1), Easily execute commands from Dovecot's libexec_dir.

doveadm instance

doveadm-instance(1), Manage the list of running Dovecot instances.

doveadm kick

doveadm-kick(1), Disconnect users by user name and/or IP address.

doveadm log

doveadm-log(1), Locate, test or reopen Dovecot's log files.

doveadm penalty

doveadm-penalty(1), Show current penalties.

doveadm proxy

doveadm-proxy(1), Handle Dovecot proxy connections.

doveadm who

doveadm-who(1); Show who is logged in to the Dovecot server.

Authentication Commands

doveadm auth

doveadm-auth(1), Test authentication for a user.

doveadm pw

doveadm-pw(1), Dovecot's password hash generator.

doveadm user

doveadm-user(1), Perform a user lookup in Dovecot's userdbs

Mailbox Commands

doveadm acl

doveadm-acl(1), Manage Access Control List (ACL).

doveadm altmove

doveadm-altmove(1), Move matching mails to the alternative storage.

doveadm backup

doveadm-backup(1), Dovecot's one-way mailbox synchronization utility.

doveadm batch

doveadm-batch(1), Execute multiple commands for multiple users.

doveadm copy

doveadm-copy(1), Copy messages matching the given search query into another mailbox.

doveadm deduplicate

doveadm-deduplicate(1), Expunge duplicate messages.

doveadm dump

doveadm-dump(1), Dump the content of Dovecot's binary mailbox index/log.

doveadm expunge

doveadm-expunge(1), Expunge messages matching given search query.

doveadm fetch

doveadm-fetch(1), Fetch messages matching given search query.

doveadm flags

doveadm-flags(1), Add, remove or replace messages' flags.

doveadm force-resync

doveadm-force-resync(1), Repair broken mailboxes, in case Dovecot doesn't automatically do that.

doveadm fs

doveadm-fs(1), Interact with the abstract mail storage filesystem.

doveadm fts

doveadm-fts(1), Manipulate the Full Text Search (FTS) index.

doveadm import

doveadm-import(1), Import messages matching given search query.

doveadm index

doveadm-index(1), Index messages in a given mailbox.

doveadm mailbox

doveadm-mailbox(1), Various commands related to handling mailboxes.

doveadm mailbox cryptokey

doveadm-mailbox-cryptokey(1), Mail crypt plugin management.

doveadm move

doveadm-move(1) Move messages matching the given search query into another mailbox.

doveadm purge

doveadm-purge(1) Remove messages with refcount=0 from mdbox files.

doveadm quota

doveadm-quota(1), Initialize/recalculate or show current quota usage.

doveadm rebuild

doveadm-rebuild(1), Rebuild index metadata from message data.

doveadm replicator

doveadm-replicator(1), Manage users' mail replication.

doveadm save

doveadm-save(1), Save email to users' mailboxes.

doveadm search

doveadm-search(1), Show a list of mailbox GUIDs and message UIDs matching given search query.

doveadm stats

doveadm-stats(1), Inspect or reset stats.

doveadm sync

doveadm-sync(1), Dovecot's two-way mailbox synchronization utility.

Exit Status

doveadm will exit with one of the following values:


Selected command was executed successful.


Command failed in some way.



This environment variable is used to determine the user if a command accepts a user but none was specified.



Dovecot's main configuration file.


Mailbox locations and namespaces.


Plugin specific settings.

Reporting Bugs

Report bugs, including doveconf -n output, to the Dovecot Mailing List <>. Information about reporting bugs is available at:

See Also

doveadm-help(1), doveconf(1), dovecot(1), doveadm-search-query(7)

Referenced By

doveadm-acl(1), doveadm-altmove(1), doveadm-auth(1), doveadm-batch(1), doveadm-deduplicate(1), doveadm-director(1), doveadm-dump(1), doveadm-exec(1), doveadm-expunge(1), doveadm-fetch(1), doveadm-flags(1), doveadm-force-resync(1), doveadm-fs(1), doveadm-fts(1), doveadm-help(1), doveadm-import(1), doveadm-index(1), doveadm-instance(1), doveadm-kick(1), doveadm-log(1), doveadm-mailbox(1), doveadm-mailbox-cryptokey(1), doveadm-move(1), doveadm-penalty(1), doveadm-proxy(1), doveadm-purge(1), doveadm-pw(1), doveadm-quota(1), doveadm-rebuild(1), doveadm-replicator(1), doveadm-save(1), doveadm-search(1), doveadm-search-query(7), doveadm-sieve(1), doveadm-stats(1), doveadm-sync(1), doveadm-user(1), doveadm-who(1), doveconf(1), dovecot(1), dovecot.conf(5), dovecot-lda(1), pigeonhole(7).

The man pages doveadm-reload(1) and doveadm-stop(1) are aliases of doveadm(1).

2014-10-07 Dovecot v2.3