VPopMail
========

Dovecot supports authenticating against external VPopMail
[http://inter7.com/vpopmail.html] virtual domain manager. Dovecot must have
been configured with '--with-vpopmail' to enable this. You can check this with
'dovecot --build-options'. See also <VMailMgr> [HowTo.VMailMgr.txt] for another
similar virtual domain manager.

If the vpopmail database contains plaintext passwords, it can be used for
non-plaintext authentication as well.

passdb parameters:

 * cache_key: If set, you can use 'auth_cache' with VPopMail. See <PAM>
   [PasswordDatabase.PAM.txt] for more information about it.
 * webmail=IP: If IP address is specified, connections from it are assumed to
   come from webmail and VPopMail's webmail usage restrictions apply. (v1.2+)

userdb parameters:

 * cache_key: Like in passdb.
 * quota_template=TEMPLATE: Template to specify quota rule, %q in value expands
   to Maildir++ quota. (v1.1+)

Example
-------

---%<-------------------------------------------------------------------------
auth default {
  passdb vpopmail {
    args = webmail=127.0.0.1
  }
  userdb vpopmail {
    args = quota_template=quota_rule=*:backend=%q
  }
}
---%<-------------------------------------------------------------------------

Using vpopmail quota's instead of dovecot
=========================================

You can use vpopmail quota's, rather than dovecot's by doing using the maildir
quota plugin, and configuring as below:

---%<-------------------------------------------------------------------------
plugin {
  quota = maildir
  quota_rule = ?:storage=0
}
---%<-------------------------------------------------------------------------

This works as follows: ? means, use an existing "maildirsize" file if present
(ie from Dovecot's quota), otherwise storage is unlimited.Vpopmail will
recreate the file if it doesn't exist when delivering new mail with its quota
setting.

vpopmail + mysql
================

Alternatively, you can use the SQL backend with the following configuration:

---%<-------------------------------------------------------------------------
driver = mysql
#
connect = host=/var/run/mysqld/mysqld.sock user=vpopmail
password=YOURPASSWORDHERE dbname=vpopmail
#
default_pass_scheme = PLAIN
#
password_query = SELECT CONCAT(pw_name, '@', pw_domain) AS user,
pw_clear_passwd AS password FROM vpopmail WHERE pw_name = '%n' AND pw_domain =
'%d'
#
user_query = SELECT pw_dir as home, 64020 AS uid, 64020 AS gid FROM vpopmail
WHERE pw_name = '%n' AND pw_domain = '%d'
---%<-------------------------------------------------------------------------

Most vpopmail installations use 89 as the uid/gid, not 64020. 

(This file was created from the wiki on 2009-10-16 04:42)
