DOVEADM-MAILBOX(1) Dovecot DOVEADM-MAILBOX(1) (NAME) doveadm-mailbox - (SYNOPSIS) doveadm [GLOBAL OPTIONS] [-f formatter] mailbox_cmd [OPTIONS] [ARGUMENTS] (DESCRIPTION) doveadm mailbox . (GLOBAL OPTIONS) doveadm(1): -D . -O . dovecot_storage_version -o . -k doveadm import_environment . -v . -i instance-name Dovecot . instance_name . -c config-file config-file . /etc/dovecot/dovecot.conf . . -o setting=value (setting) /etc/dovecot/dovecot.conf userdb value . -o . -f formatter (formatter) . : flow key=value . json JSON JSON . pager key: value (^L) . tab (tab) . table . -A -A command . userdb { driver = passwd } UID first_valid_uid . SQL userdb userdb_sql_iterate_query . LDAP userdb userdb_fields userdb_ldap_iterate_fields (schema) LDAP . doveadm(1) . -F file command file. -A userdb file . file . --no-userdb-lookup userdb . USER . -S socket_path (UNIX domain socket) (hostname:port) TCP. doveadm(1) . -u user/mask command user . (wildcard) <<*>> <> ( -u *@example.org). (ARGUMENTS) mailbox mailbox IMAP UTF-8 . '/' '.' namespace . namespace . (COMMANDS) mailbox create doveadm [GLOBAL OPTIONS] mailbox create [-A | -u user | -F file | --no- userdb-lookup] [-S socket_path] [-g guid] [-s] mailbox... . mail_driver mail userdb . -g guid GUID . -s (subscriptions) . doveadm [GLOBAL OPTIONS] mailbox cryptokey export|generate|list|password mail crypt . doveadm-mailbox- cryptokey(1) . mailbox delete doveadm [GLOBAL OPTIONS] mailbox delete [-A | -u user | -F file | --no- userdb-lookup] [-S socket_path] [-s] [-r] [-e] [-Z] mailbox... (expunge) . -r . -r . -s . -e . -Z (consistent) (quota) . . mailbox list doveadm [GLOBAL OPTIONS] mailbox list [-7 | -8] [-A | -u user | -F file | --no-userdb-lookup] [-S socket_path] [-s] [mailbox ...] . (wildcards) mailbox . -s . . -7 mUTF-7 . -8 UTF-8 . mailbox metadata list doveadm [GLOBAL OPTIONS] mailbox metadata list [-A | -u user | -F file | --no-userdb-lookup] [-S socket_path] [-s] [-p] mailbox [key-prefix] -s "" mailbox . mailbox . -p . mailbox (). -s "" . key-prefix . . doveadm [GLOBAL OPTIONS] mailbox metadata get [-A | -u user | -F file | --no-userdb-lookup] [-S socket_path] [-s] mailbox key -s "" mailbox . mailbox . mailbox (). -s "" . key . mailbox metadata set doveadm [GLOBAL OPTIONS] mailbox metadata set [-A | -u user | -F file | --no-userdb-lookup] [-S socket_path] [-s] mailbox key value -s "" mailbox . mailbox . mailbox (). -s "" . key . value . mailbox metadata unset doveadm [GLOBAL OPTIONS] mailbox metadata unset [-A | -u user | -F file | --no-userdb-lookup] [-S socket_path] [-s] mailbox key -s "" mailbox . mailbox . mailbox (). -s "" . key (unset) . doveadm [GLOBAL OPTIONS] mailbox mutf7 [-7 | -8] name... mailbox mutf7 name UTF-7 . RFC 3501 (Mailbox International Naming Convention) . -7 name mUTF-7 UTF-8 . -8 name UTF-8 mUTF-7 (). name . mailbox path doveadm [GLOBAL OPTIONS] mailbox path [-A | -u user | -F file | --no- userdb-lookup] [-S socket_path] [-s] [-t type] mailbox mailbox path . <> . -t type . : o alt-dir o alt-mailbox o control o dir o index () o index-cache o index-private o list-index o mailbox mailbox (). doveadm [GLOBAL OPTIONS] mailbox rename [-A | -u user | -F file | --no- userdb-lookup] [-S socket_path] [-s] old_name new_name mailbox rename old_name new_name . -s old_name new_name . mailbox status doveadm [GLOBAL OPTIONS] mailbox status [-A | -u user | -F file | --no- userdb-lookup] [-S socket_path] [-t] fields mailbox... status () . mailbox (wildcards) . (formatter) flow . -t (fields) messages recent unseen / vsize (total). fields (fields) . . all : . (fields) . -t messages recent unseen vsize . guid : (globally unique identifier) (mailbox). highestmodseq : (mod-sequence) mailbox. messages : mailbox. deleted : \Deleted . recent : \Recent . uidnext : . uidvalidity : (unique identifier validity). unseen : mailbox. vsize : mailbox CRLF. firstsaved : . doveadm [GLOBAL OPTIONS] mailbox subscribe [-A | -u user | -F file | --no-userdb-lookup] [-S socket_path] mailbox ... . mailbox unsubscribe doveadm [GLOBAL OPTIONS] mailbox unsubscribe [-A | -u user | -F file | --no-userdb-lookup] [-S socket_path] mailbox ... . mailbox update doveadm [GLOBAL OPTIONS] mailbox update [-A | -u user | -F file | --no- userdb-lookup] [-S socket_path] [--mailbox-guid guid] [--uid-validity uid] [--min-next-uid uid] [--min-first-recent-uid uid] [--min-highest- modseq seq] [--min-highest-pvt-modseq seq] mailbox ... UID validity UID (next UID) UID (first recent UID) (modification sequence) . (migration) . (mail backends) . mailbox cache purge doveadm [GLOBAL OPTIONS] mailbox cache purge [-A | -u user | -F file | --no-userdb-lookup] [-S socket_path] mailbox ... dovecot.index.cache. . . mailbox cache decision doveadm [GLOBAL OPTIONS] mailbox cache decision [-A | -u user | -F file | --no-userdb-lookup] [-S socket_path] [--all] [--fields list of fields] [--last-used unix timestamp] [--decision no|temp|yes] mailbox ... (caching decisions) () () . decision last-used . --all . --fields . --decision . Yes . Temp . No . --last-used (timestamp) . : (cache) ! . no . mailbox cache remove doveadm [GLOBAL OPTIONS] mailbox cache remove [-A | -u user | -F file | --no-userdb-lookup] [-S socket_path] search query () (cache). ! . doveadm-search-query(7) . (EXAMPLES) bob 'dovecot' : doveadm mailbox list -s -u bob dovecot\* dovecot dovecot/pigeonhole dovecot/pigeonhole/2.0 dovecot bob: doveadm -f table mailbox status -u bob "messages vsize" dovecot\* mailbox messages vsize dovecot 20501 93968492 dovecot/pigeonhole 0 0 dovecot/pigeonhole/2.0 47 323474 mUTF-7 UTF-8 : doveadm mailbox mutf7 -7 "~peter/mail/&U,BTFw-/&ZeVnLIqe-" ~peter/mail// doveadm mailbox mutf7 ~peter/mail// ~peter/mail/&U,BTFw-/&ZeVnLIqe- doveconf -n Dovecot . : (SEE ALSO) doveadm(1) e5ac02a May 2026 DOVEADM-MAILBOX(1)