Next Previous Contents

3. Putting it all together

3.1 Basic Qmail config

You will need to add your domains to the /var/qmail/control/virtualdomains file in the following format as is normal with qmail and VMailMgr.

  domain1.com:user1
For more detailed setup and config documentation visit the Qmail website http://www.qmail.org and the VMailMgr website http://em.ca/~bruceg/VMailMgr/

3.2 Tell Qmail to use VMailMgr for authentication

By default qmail uses checkpassword for authentication, to tell Qmail to use VMailMgr for authentication type the following command:

  echo checkvpw > /var/qmail/control/checkpassword

3.3 Setup Courier-imap for VMailMgr

Copy the VMailMgr auth libs to courier's directory

  cp /usr/bin/authvmailmgr /usr/lib/courier-imap/libexec/authlib/

Edit /usr/lib/courier-imap/etc/imapd.config and add authvmailmgr as the first entry in AUTHMODULES

For more detailed setup and config documentation visit the Courier-imap website http://www.inter7.com/courierimap/

3.4 Setup virtual domain with VMailMgr

With the user account that will be managing the domain go to their home dir and type:

  vsetup

This will setup the users home dir with the necessary structure to handle incoming email. You will probably want to create a email account by typing

  vadduser emailuser

For more detailed setup and config documentation visit the VMailMgr website http://em.ca/~bruceg/VMailMgr/

3.5 Starting the daemons

Start Qmail daemons

  /etc/rc.d/init.d/qmail start
  /etc/rc.d/init.d/pop3d start
  /etc/rc.d/init.d/smtp start
  /etc/rc.d/init.d/qmqpd start (optional)
  /etc/rc.d/init.d/qmtpd start (optional)

Start VMailMgr daemon

  /etc/rc.d/init.d/vmailmgrd start

Start Courier-imap damon

  /etc/rc.d/init.d/courier-imap start

3.6 Some considerations left

Qmail and the Maildirs may cause some email apps that run locally to not work. Visit the Qmail website http://www.qmail.org for details on email apps that have been patched to work with Maildirs.

Courier-imap is not as widely used as Cyrus or UWash imap servers. As such, you may suffer from minor incompatibilities. Courier-imap is extremely well written, and tries to comply with the imap definition even if it means some imap clients wont work well. For details visit the Courier-imap website http://www.inter7.com/courierimap/.

3.7 Known bugs

None yet.

3.8 The final word

Im tired, and wonder if anyone will ever use this, but I'm happy its done. I'm sure if you have read this far your tired too. Well, all I can hope is that you have Qmail, VMailMgr and Courier-imap working. If so, Enjoy! If not, bummer!

O.K. readers, you're done for today. Feel free to send me your feedback, eternal gratitude, flowers, ecash, cars, oil sources etc.


Next Previous Contents