|Qmail VMailMgr and Courier-Imap HOWTO|
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://www.vmailmgr.org
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
Copy the VMailMgr auth libs to courier's directory. If you installed from RPM, then the vmailmgr-courier-imap RPM will have done this for you. Otherwise use this command:
cp /usr/bin/authvmailmgr /usr/lib/courier-imap/libexec/authlib/
Edit /usr/lib/courier-imap/etc/imapd and add authvmailmgr as the only entry in AUTHMODULES
For more detailed setup and config documentation visit the Courier-imap website http://www.inter7.com/courierimap/
With the user account that will be managing the domain go to their home dir and type:
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
For more detailed setup and config documentation visit the VMailMgr website http://www.vmailmgr.org
Starting the Qmail daemon. Qmail installs itself to autostart by some mysterious (to me) way. If you like init scripts you can get Larry Doolittle's (email@example.com) init.d script at http://qmail.area.com/init.d-script If you have the Larry's init.d script just do this.
Start VMailMgr daemon
Start Courier-imap damon
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/.
With the solution you should now have setup you will need to know that user accounts will be firstname.lastname@example.org Netscape does not like this, so for netscape use user:domain.com
I would like to suggest that you also checkout phpGroupWare at http://www.phpgroupware.org. I have built in support for vmailmgr into it already and it can give you an end result of a full Groupware solution to fend of MS Exchange/Outlook or Lotus Domino.
If you decide to use a web based mail client, you will probably want to adjust courier-imaps MAXPERIP setting. By default it is 4, which is a bit low. Bump it up to something more sensible, like 10 - 50. Otherwise our webmail users will have problems connecting. This setting is in /usr/lib/courier-imap/etc/imapd.
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.