DOVEADM-AUTH(1)                     Dovecot                    DOVEADM-AUTH(1)

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

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       doveadm [GLOBAL OPTIONS] auth command [OPTIONS] [ARGUMENTS]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?><?><?> doveadm auth <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?>.

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

       -D

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



       -O

           <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?><?> dovecot_storage_version
           <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?> -o
           <?><?><?><?><?><?><?><?> <?><?><?>.



       -k

           <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> doveadm <?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
           import_environment <?><?>.



       -v

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



       -i instance-name

           <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?> (instance) <?><?> 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

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


       table

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




<?><?><?><?><?><?><?><?> (OPTIONS)
       -x auth_info

           <?><?><?><?><?><?><?> auth_info <?><?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?> user <?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?><?><?> auth_info
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> name = value
           <?><?><?><?> <?><?><?>. <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
           -x <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>.

           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> auth_info
           <?><?><?><?><?><?><?> <?><?>:

           service

               <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> userdb
               <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>.
               <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
               <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
               <?><?> Dovecot <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
               <?><?><?><?> <?><?><?><?><?>: imap<?> pop3 <?><?> smtp.


       session

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


       lip

           <?><?><?><?> IP <?><?><?><?> (<?><?><?><?>) <?><?><?><?>
           <?><?><?><?><?><?>.


       rip

           <?><?><?><?> IP <?><?><?> <?><?><?> (<?><?><?><?><?><?>)
           <?><?><?><?> <?><?><?><?><?><?>.


       lport

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


       rport

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


       real_lip

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


       real_rip

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


       real_lport

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


       real_rport

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


       forward_<field>

           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           %{forward:field} <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> (auth) <?><?><?><?><?> <?><?><?>.




<?><?><?><?><?><?><?><?><?><?> (ARGUMENTS)
       user

           <?><?><?> <?><?><?><?><?><?> <?><?><?><?> user. <?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           jane <?><?> <john@example.com> <?><?><?><?>.



       password

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



<?><?><?><?><?><?><?> (COMMANDS)
   auth cache flush
       doveadm [GLOBAL OPTIONS] auth cache flush [-a master_socket_path]
       [user-mask ...]

       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (<?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> SIGHUP <?><?> <?><?><?><?><?><?> auth <?><?><?>
       <?><?><?><?><?> <?><?><?>). <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> (user-mask) <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?>.

       -a master_socket_path

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

           <?><?><?><?><?><?> <?><?><?><?><?><?><?> doveadm(1) <?><?>
           <?><?><?><?> /rundir/auth-master <?><?><?><?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> base_dir <?><?> /etc/dovecot/dovecot.conf
           <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.



       -x auth_info

           <?><?><?><?><?><?><?> auth_info <?><?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?> user <?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?><?><?> auth_info
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> name = value
           <?><?><?><?> <?><?><?>. <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
           -x <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>.

           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> auth_info
           <?><?><?><?><?><?><?> <?><?>:

           service

               <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> userdb
               <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>.
               <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
               <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
               <?><?> Dovecot <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
               <?><?><?><?> <?><?><?><?><?>: imap<?> pop3 <?><?> smtp.


       session

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


       lip

           <?><?><?><?> IP <?><?><?><?> (<?><?><?><?>) <?><?><?><?>
           <?><?><?><?><?><?>.


       rip

           <?><?><?><?> IP <?><?><?> <?><?><?> (<?><?><?><?><?><?>)
           <?><?><?><?> <?><?><?><?><?><?>.


       lport

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


       rport

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


       real_lip

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


       real_rip

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


       real_lport

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


       real_rport

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


       forward_<field>

           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           %{forward:field} <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> (auth) <?><?><?><?><?> <?><?><?>.




   auth lookup
       doveadm [GLOBAL OPTIONS] auth lookup [-a userdb_socket_path] [-x
       auth_info] [-f field] user [...]

       <?><?><?><?><?> <?><?><?><?><?> doveadm-user(1) <?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> userdb<?> <?><?> <?><?><?><?><?> <?><?> passdb (<?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>) <?><?><?><?><?>
       <?><?><?><?><?><?>.

       -a userdb_socket_path

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

           <?><?><?><?><?><?> <?><?><?><?><?><?><?> doveadm(1) <?><?>
           <?><?><?><?> /rundir/auth-userdb <?><?><?><?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> base_dir <?><?> /etc/dovecot/dovecot.conf
           <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.



       -f field

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



       -x auth_info

           <?><?><?><?><?><?><?> auth_info <?><?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?> user <?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?><?><?> auth_info
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> name = value
           <?><?><?><?> <?><?><?>. <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
           -x <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>.

           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> auth_info
           <?><?><?><?><?><?><?> <?><?>:

           service

               <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> userdb
               <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>.
               <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
               <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
               <?><?> Dovecot <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
               <?><?><?><?> <?><?><?><?><?>: imap<?> pop3 <?><?> smtp.


       session

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


       lip

           <?><?><?><?> IP <?><?><?><?> (<?><?><?><?>) <?><?><?><?>
           <?><?><?><?><?><?>.


       rip

           <?><?><?><?> IP <?><?><?> <?><?><?> (<?><?><?><?><?><?>)
           <?><?><?><?> <?><?><?><?><?><?>.


       lport

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


       rport

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


       real_lip

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


       real_rip

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


       real_lport

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


       real_rport

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


       forward_<field>

           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           %{forward:field} <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> (auth) <?><?><?><?><?> <?><?><?>.




   auth test
       doveadm [GLOBAL OPTIONS] auth test [-a auth_socket_path] [-A sasl_mech]
       [-x auth_info] user [password]

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

       -a auth_socket_path

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

           <?><?><?><?><?><?> <?><?><?><?><?><?><?> doveadm(1) <?><?>
           <?><?><?><?> /rundir/auth-client <?><?><?><?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> base_dir <?><?> /etc/dovecot/dovecot.conf
           <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.



       -A sasl_mech

           <?><?><?><?><?><?><?> SASL <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?>. <?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> PLAIN <?><?><?><?><?><?><?>
           <?><?><?><?><?><?>.



       -x auth_info

           <?><?><?><?><?><?><?> auth_info <?><?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?> user <?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?><?><?> auth_info
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> name = value
           <?><?><?><?> <?><?><?>. <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
           -x <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>.

           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> auth_info
           <?><?><?><?><?><?><?> <?><?>:

           service

               <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> userdb
               <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>.
               <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
               <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
               <?><?> Dovecot <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
               <?><?><?><?> <?><?><?><?><?>: imap<?> pop3 <?><?> smtp.


       session

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


       lip

           <?><?><?><?> IP <?><?><?><?> (<?><?><?><?>) <?><?><?><?>
           <?><?><?><?><?><?>.


       rip

           <?><?><?><?> IP <?><?><?> <?><?><?> (<?><?><?><?><?><?>)
           <?><?><?><?> <?><?><?><?><?><?>.


       lport

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


       rport

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


       real_lip

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


       real_rip

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


       real_lport

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


       real_rport

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


       forward_<field>

           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           %{forward:field} <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> (auth) <?><?><?><?><?> <?><?><?>.




   auth login
       doveadm [GLOBAL OPTIONS] auth login [-a auth_socket_path] [-m
       auth_master_socket_path] [-A sasl_mech] [-x auth_info] user [password]

       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> passdb (<?><?><?><?><?> <?><?><?><?>) <?> <?><?>
       <?><?><?><?><?> <?><?> userdb (<?><?><?><?>) <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.

       -a auth_socket_path

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

           <?><?><?><?><?><?> <?><?><?><?><?><?><?> doveadm(1) <?><?>
           <?><?><?><?> /rundir/auth-client <?><?><?><?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> base_dir <?><?> /etc/dovecot/dovecot.conf
           <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.



       -m auth_master_socket_path

           <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?> (master socket) <?><?><?><?><?><?><?>
           <?><?><?><?><?><?>.

           <?><?><?><?><?><?> <?><?><?><?><?><?><?> doveadm(1) <?><?>
           <?><?><?><?> /rundir/auth-master <?><?><?><?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> base_dir <?><?> /etc/dovecot/dovecot.conf
           <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.



       -A sasl_mech

           <?><?><?><?><?><?><?> SASL <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?>. <?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> PLAIN <?><?><?><?><?><?><?>
           <?><?><?><?><?><?>.



       -x auth_info

           <?><?><?><?><?><?><?> auth_info <?><?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?> user <?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?><?><?> auth_info
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> name = value
           <?><?><?><?> <?><?><?>. <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
           -x <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>.

           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> auth_info
           <?><?><?><?><?><?><?> <?><?>:

           service

               <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> userdb
               <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>.
               <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
               <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
               <?><?> Dovecot <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
               <?><?><?><?> <?><?><?><?><?>: imap<?> pop3 <?><?> smtp.


       session

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


       lip

           <?><?><?><?> IP <?><?><?><?> (<?><?><?><?>) <?><?><?><?>
           <?><?><?><?><?><?>.


       rip

           <?><?><?><?> IP <?><?><?> <?><?><?> (<?><?><?><?><?><?>)
           <?><?><?><?> <?><?><?><?><?><?>.


       lport

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


       rport

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


       real_lip

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


       real_rip

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


       real_lport

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


       real_rport

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


       forward_<field>

           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           %{forward:field} <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> (auth) <?><?><?><?><?> <?><?><?>.




<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> imap <?><?> <?><?><?><?> <?><?><?><?><?> john <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> IP <?><?>
       <?><?><?><?><?> 192.0.2.143 <?><?><?><?> <?><?><?> <?><?><?>.

         doveadm auth test -x service=imap -x rip=192.0.2.143 john

         Password:
         passdb: john auth succeeded
         extra fields:
           user=john

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

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

e5ac02a                            May 2026                    DOVEADM-AUTH(1)