Inspect Dovecot authentication fields for one user
Build a paste-ready command, then review its compatibility and effects before running it.
doveadm auth lookup <dovecot-user>Complete required fields to copy the generated command.
read-onlyrequires privileges Compatibility
LinuxVerified for Linux using posix, bash, zsh syntax.
Operational knowledgereview due 2027-01-19
Requirementsdoveadmdoveadm must be installed and available on PATH.Elevated accessReview the exact scope before using an elevated account.
Version supportdoveadm Current supported releasesVerified for linux using posix, bash, zsh syntax; consult compatibility notes for platform-specific differences.
Expected signalspassdb: alice@example.com auth succeededRepresentative successful output; values vary with the selected target and system state.
Known errorsdoveadm: command not founddoveadm is missing or is not available on PATH.Permission deniedThe current identity does not have the required access.
Verifydoveadm auth lookup {{user}}The output matches the expected target and exits without an error.Rollback noteNo universal automatic rollback is available. Capture the current state and use the tool-specific recovery procedure before applying changes.
Command breakdown
01doveadmCommandRuns the doveadm stage of this one-liner.
02authArgumentPasses auth to doveadm.
03lookupArgumentPasses lookup to doveadm.
04<dovecot-user>ParameterA value supplied in the Fill parameters section.
Example input
doveadm auth lookup alice@example.com
Example output
passdb: alice@example.com auth succeeded
extra fields:
user=alice@example.com
Illustrative output — exact values vary by system and data.
Official sources
Related commands