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

Please feel free to experiment here, after the four dashes below... and please do NOT create new pages without any meaningful content just to try it out.

Tip: Shift-click "HelpOnEditing" to open a second window with the help pages.


Check out the preformatted monospace.


italic bold typewriter

backtick typewriter (configurable)



HelpOnEditing InterWiki Python







Simple Virtual Domain Howto

Ive read SimpleVirtualHowto from the wiki, but its unclear in some cases imho and contains errors in others. So this is my try todo it right. After making the described changes you will have the following: - imap(s)/pop3(s) access to youruser@yourdomain.xy (sending and receiving) - sending is unencrypted, will be added later

This is my first mail server installation, so please correct me if this howto contains mistakes. This is based on a debian lenny installation.

this is the complete dovecot.conf file that you need replace in the config below: postmaster_address

protocols = imap imaps pop3 pop3s

log_path = /var/log/dovecot.log
info_log_path = /var/log/dovecot-info.log

disable_plaintext_auth = no

mail_location = maildir:~/Maildir

pop3_uidl_format = %08Xu%08Xv

auth_verbose = yes

auth_debug = yes

protocol lda {
        postmaster_address =

auth default {
        mechanisms = plain
        passdb passwd-file {
                args = /etc/dovecot/passwd
        userdb static {
                args = uid=vmail gid=vmail home=/home/vmail/%u

        socket listen {
                master {
                        path = /var/run/dovecot/auth-master
                        mode = 0777 #NOT SECURE; HAVE TO CHECK
                #needed for smtpd sasl 
                client {
                       path = /var/spool/postfix/private/auth
                       mode = 0660
                       user = postfix
                       group = postfix

replace in the config below: virtual_mailbox_domains

append these lines to: /etc/postfix/

dovecot_destination_recipient_limit = 1
virtual_mailbox_domains =
virtual_transport = dovecot

append these lines to: /etc/postfix/

dovecot   unix  -       n       n       -       -       pipe
  flags=DRhu user=vmail:vmail argv=/usr/lib/dovecot/deliver -f ${sender} -d ${recipient}

you also need to create the vmail user, on debian use:

adduser vmail --shell /bin/false --disabled-login

enter random data for all the other fields.

tell dovecot about your virtual user: /etc/dovecot/passwd{PLAIN}yourpassword

TODO: check permissions for /var/run/dovecot/auth-master and /var/log/dovecot.log and /var/log/dovecot-info.log

None: WikiSandBox (last edited 2010-05-06 14:55:33 by metalfan)