This documentation is for Dovecot v2.x, see wiki1 for v1.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.

Formatting

italic bold typewriter

backtick typewriter (configurable)

preformatted

Linking

HelpOnEditing InterWiki

http://purl.net/wiki/moin/ Python

someone@the.inter.net

.

http://c2.com/sig/wiki.gif

Lists

Bullet

Glossary

Term
Definition
Term2
Def2

Drawing


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

#/etc/dovecot/dovecot.conf
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 = julius@abm.ath.cx
}

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/main.cf

dovecot_destination_recipient_limit = 1
virtual_mailbox_domains = abm.ath.cx
virtual_transport = dovecot

append these lines to: /etc/postfix/master.cf

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

someuser@abm.ath.cx:{PLAIN}yourpassword

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


Filesystem layout diagrams

Method 1

This method uses hard space characters (specifically, em-dash, U+2003) to do indentation. Easy to read and maintain the markup. Indentation scale controllable by changing the number and/or type of space characters used; here we have 3 × em-dash.

<mail location root>/

   mailboxes/

      INBOX/

         dbox-Mails/

            dovecot.index*

Index files for INBOX

      foo/

         dbox-Mails/

            dovecot.index*

Index files for mailbox "foo"

         bar/

            dbox-Mails/

               dovecot.index*

Index files for mailbox "foo/bar"

   dovecot.mailbox.log*

Mailbox changelog

   subscriptions

subscribed mailboxes list

   dovecot-uidvalidity*

IMAP UID validity

Method 2

This method uses empty table cells to do indentation. Hard to read and maintain the markup. Indentation scale may be settable by setting the width of the empty cells.

<mail location root>/

mailboxes/

INBOX/

dbox-Mails/

dovecot.index*

Index files for INBOX

foo/

dbox-Mails/

dovecot.index*

Index files for mailbox "foo"

bar/

dbox-Mails/

dovecot.index*

Index files for mailbox "foo/bar"

dovecot.mailbox.log*

Mailbox changelog

subscriptions

subscribed mailboxes list

dovecot-uidvalidity*

IMAP UID validity

None: WikiSandBox (last edited 2011-04-29 15:41:41 by TimoSirainen)