DOVEADM-SEARCH(1)                   Dovecot                  DOVEADM-SEARCH(1)

<?><?><?> (NAME)
       doveadm-search - <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       GUID<?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?> UID<?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       doveadm [<?><?><?><?><?><?><?><?><?> <?><?><?><?><?>] [-f
       <?><?><?><?><?><?><?><?>] search [-S socket_path] -A search_query

       doveadm [<?><?><?><?><?><?><?><?><?> <?><?><?><?><?>] [-f
       <?><?><?><?><?><?><?><?>] search [-S socket_path] -F file search_query

       doveadm [<?><?><?><?><?><?><?><?><?> <?><?><?><?><?>] [-f
       <?><?><?><?><?><?><?><?>] search [-S socket_path] --no-userdb-lookup
       search_query

       doveadm [<?><?><?><?><?><?><?><?><?> <?><?><?><?><?>] [-f
       <?><?><?><?><?><?><?><?>] search [-S socket_path] -u user search_query

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> search <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>.  doveadm(1) <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> guid <?><?><?><?><?> <?><?><?><?>
       <?> <?><?><?><?><?> uid <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?>.

       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?> -A <?><?>
       -u wildcard <?><?><?><?><?><?><?> <?><?><?><?> doveadm(1)
       <?><?><?><?><?><?><?> username<?> mailbox-guid <?> uid <?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?>.

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

       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> file
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?>.

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

       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       user(<?><?><?>) <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.

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

       -D

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



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


       pager

           <?><?> <?><?><?> key: value <?><?> <?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?> <?>
           <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> Form Feed
           (^L) <?><?> <?><?> <?><?><?> <?><?><?><?><?><?>.


       tab

           <?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?>
           <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> Tab
           <?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>.


       table

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




       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> flow (<?><?><?><?>
       <?><?><?><?><?><?> key=) <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

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

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

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

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



       -F file

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



       --no-userdb-lookup

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



       -S socket_path

           <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> (UNIX domain socket)
           <?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?> <?> <?><?><?><?><?> (hostname:port) <?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?> TCP.

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



       -u user/mask

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



<?><?><?><?><?><?><?><?><?><?> (ARGUMENTS)
       search_query

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



<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?> Subject: <?><?><?><?><?> <?><?><?><?> "todo"
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> dovecot <?><?><?><?><?> bob:

         doveadm search -u bob mailbox dovecot\* subject todo

         3a94c928d66ebe4bda04000015811c6a   8
         3a94c928d66ebe4bda04000015811c6a   25
         3a94c928d66ebe4bda04000015811c6a   45

       <?><?><?><?><?> search <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       doveadm-fetch(1) <?><?><?><?><?><?><?> <?><?><?>.

       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> INBOX <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       "todo" <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>:

         doveadm search -u bob mailbox INBOX subject todo
         while read guid uid; do
           doveadm fetch -u bob body mailbox-guid $guid uid $uid > msg.$uid
         done

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

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       doveadm(1), doveadm-search-query(7)

e5ac02a                            May 2026                  DOVEADM-SEARCH(1)