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


This is a virtual domain manager in use with Qmail. See

Dovecot supports authentication via checkpassword interface. VMailMGR summarily implements such interface, but requires minor adjustments. You use a dovecot to VMailMgr wrapper for doing such adjustments and interfacing VMailMgr properly with dovecot.

Installation and configuration

The wrapper runs the VMailMgr authenticator, collects its result (most notably, the mailbox's path) and passes them back to dovecot.

The setup is as follows:

  1. download the source file of the vmailmgr-to-dovecot wrapper

  2. compile the wrapper:
    cc -Wall -O2 -o checkvpw-dovecot-wrapper checkvpw-dovecot-wrapper.c
  3. place the wrapper somewhere in the system:
    install -s -o root checkvpw-dovecot-wrapper /usr/local/bin
  4. configure dovecot to use the wrapper as a standard checkpassword module. Make dovecot.conf look like this:

    mail_location = maildir:%h
    auth default {
        mechanism = plain
        passdb checkpassword {
            args = /usr/local/bin/checkvpw-dovecot-wrapper
        userdb prefetch {
        user = root
  5. restart dovecot.


The wrapper relies on VMailMgr's authenticator checkvpw. By default, this is expected at /usr/local/bin/checkvpw. If authentication fails, make sure that is available at that location first. The location of checkvpw can be configured by changing the CHECKVPW_BINARY_PATH constant in the top of the wrapper's code, then recompiling it.

Refer to Debugging/Authentication for more details on debugging auth.

None: HowTo/VMailMgr (last edited 2009-08-07 20:06:45 by mac-dkr04)