This documentation is for Dovecot v2.x, see wiki1 for v1.x documentation.

User Databases

After a user has been successfully authenticated, Dovecot looks up the user's userdb information. The userdb lookup is also done by LDA to find out how to deliver mails for the user.

The user database lookup returns these fields:

The user and password databases may be the same or they may be different depending on your needs. You can also have multiple databases.

Currently supported user databases are:

Userdb settings

An example userdb entry might look like this:

userdb {
  driver = passwd-file
  args = username_format=%n /etc/dovecot/users

  default_fields = uid=vmail gid=vmail
  override_fields = 

  # v2.2.10+:
  skip = never
  result_failure = continue
  result_internalfail = continue
  result_success = return-ok

  # v2.2.24+:
  auth_verbose = default

First we have the settings that provide content for the userdb lookup:

Then we have the setting which specify when the userdb is used (v2.2.10+):

And finally we can control what happens when we're finished with this userdb (v2.2.10+):

The result values that can be used: