DOVEADM-FLAGS(1)                    Dovecot                   DOVEADM-FLAGS(1)

<?><?><?> (NAME)
       doveadm-flags - <?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       doveadm [GLOBAL OPTIONS] flags [-S socket_path] -A command flags
       search_query

       doveadm [GLOBAL OPTIONS] flags [-S socket_path] -F file command flags
       search_query

       doveadm [GLOBAL OPTIONS] flags [-S socket_path] --no-userdb-lookup
       command flags search_query

       doveadm [GLOBAL OPTIONS] flags [-S socket_path] -u user command flags
       search_query

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (GLOBAL OPTIONS)
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> doveadm(1):

       -D

           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (verbosity) <?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>.



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



<?><?><?><?><?><?><?><?> (OPTIONS)
       -A

           <?><?><?> <?><?><?><?><?> -A <?><?><?><?><?> <?><?><?><?><?>
           command <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?>. <?><?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> userdb { driver = passwd }
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> UID <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> first_valid_uid <?><?><?> <?><?><?><?><?><?>.

           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> SQL
           userdb<?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
           userdb_sql_iterate_query <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?>
           <?><?><?><?>.

           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> LDAP
           userdb<?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
           userdb_fields <?> userdb_ldap_iterate_fields <?><?>
           <?><?><?><?><?><?><?> LDAP <?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?>. <?><?> <?><?><?> <?><?><?> <?><?><?><?> doveadm(1)
           <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.



       -F file

           <?><?><?><?><?> command <?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> file. <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> -A <?><?><?><?>
           <?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> userdb<?> <?><?><?><?><?> <?><?> file
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>.
           <?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?>
           <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?>.



       --no-userdb-lookup

           <?><?><?> <?><?><?><?><?> <?><?> userdb. <?><?> <?><?><?><?><?>
           <?><?><?><?><?> USER <?><?><?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.



       -S socket_path

           <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
           <?><?> <?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?>
           (hostname:port) <?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?> TCP.

           <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?> doveadm(1) <?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>.



       -u user/mask

           <?><?><?><?><?> command <?><?><?> <?><?><?><?> user
           <?><?><?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
           '*' <?> '?' <?><?><?><?> <?><?><?><?> (<?><?><?><?><?> -u
           *@example.org).



<?><?><?><?><?><?><?><?><?><?> (ARGUMENTS)
       flags

           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?> <?><?> RFC 3501<?> <?><?><?> 2.3.2 (<?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?>) <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?>: \Answered<?> \Deleted<?> \Draft<?>
           \Flagged<?> \Recent <?> \Seen. <?>
           <?><?><?><?><?><?><?><?><?><?><?><?> IMAP <?><?><?><?>
           $Forwarded<?> $MDNSent<?> $SubmitPending <?> $Submitted <?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> Junk<?> $NonSpam
           <?><?> $Label1.

           <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?>
           <?>/<?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?>.



       search_query

           <?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?> doveadm-search-
           query(7) <?><?> <?><?><?><?><?><?>.



<?><?><?><?><?><?><?> (COMMANDS)
   flags add
       doveadm [GLOBAL OPTIONS] flags add [-u user | -A | -F file | --no-
       userdb-lookup] [-S socket_path] flags search_query

       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> flags <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

   flags remove
       doveadm [GLOBAL OPTIONS] flags remove [-u user | -A | -F file | --no-
       userdb-lookup] [-S socket_path] flags search_query

       <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> flags <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.

   flags replace
       doveadm [GLOBAL OPTIONS] flags replace [-u user | -A | -F file | --no-
       userdb-lookup] [-S socket_path] flags search_query

       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> flags
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?> (EXAMPLE)
       <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> uid
       <?><?><?><?><?> <?><?> 81563:

         doveadm fetch -u bob 'uid flags' mailbox dovecot uid 81563

         uid: 81563
         flags: \Answered \Seen NonJunk

         doveadm flags remove -u bob NonJunk mailbox dovecot uid 81563
         doveadm flags add -u bob '\Flagged $Forwarded' mailbox dovecot uid 81563

<?><?><?><?><?> <?><?><?><?><?><?><?> (REPORTING BUGS)
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       doveconf -n <?><?> <?><?><?><?><?> <?><?><?><?> Dovecot <?><?>
       <?><?><?><?><?> <dovecot@dovecot.org> <?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <https://dovecot.org/bugreport.html> <?><?> <?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       doveadm(1)

e5ac02a                            May 2026                   DOVEADM-FLAGS(1)