<HTML ><HEAD ><TITLE >Putting it all together</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ "><LINK REL="HOME" TITLE="Qmail VMailMgr and Courier-Imap HOWTO" HREF="index.html"><LINK REL="PREVIOUS" TITLE="Component installation" HREF="x137.html"></HEAD ><BODY CLASS="SECT1" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >Qmail VMailMgr and Courier-Imap HOWTO</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="x137.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" > </TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="SECT1" ><H1 CLASS="SECT1" ><A NAME="AEN380">3. Putting it all together</H1 ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="AEN382">3.1. Basic Qmail config</H2 ><P >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 <A HREF="http://www.qmail.org" TARGET="_top" >http://www.qmail.org</A > and the VMailMgr website <A HREF="http://www.vmailmgr.org" TARGET="_top" >http://www.vmailmgr.org</A ></P ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="AEN387">3.2. Tell Qmail to use VMailMgr for authentication</H2 ><P >By default qmail uses checkpassword for authentication, to tell Qmail to use VMailMgr for authentication type the following command: <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="PROGRAMLISTING" > echo checkvpw > /var/qmail/control/checkpassword</PRE ></FONT ></TD ></TR ></TABLE ></P ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="AEN391">3.3. Setup Courier-imap for VMailMgr</H2 ><P >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: <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="PROGRAMLISTING" > cp /usr/bin/authvmailmgr /usr/lib/courier-imap/libexec/authlib/</PRE ></FONT ></TD ></TR ></TABLE ></P ><P >Edit <TT CLASS="LITERAL" >/usr/lib/courier-imap/etc/imapd</TT > and add authvmailmgr as the only entry in AUTHMODULES</P ><P >For more detailed setup and config documentation visit the Courier-imap website <A HREF="http://www.inter7.com/courierimap/" TARGET="_top" >http://www.inter7.com/courierimap/</A ></P ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="AEN399">3.4. Setup virtual domain with VMailMgr</H2 ><P >With the user account that will be managing the domain go to their home dir and type: <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="PROGRAMLISTING" > vsetup</PRE ></FONT ></TD ></TR ></TABLE ></P ><P >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</P ><P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="PROGRAMLISTING" > vadduser emailuser</PRE ></FONT ></TD ></TR ></TABLE ></P ><P >For more detailed setup and config documentation visit the VMailMgr website <A HREF="http://www.vmailmgr.org" TARGET="_top" >http://www.vmailmgr.org</A ></P ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="AEN408">3.5. Starting the daemons</H2 ><P > 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 (<A HREF="ldoolitta@ajlab.org" TARGET="_top" >ldoolitta@ajlab.org</A >) init.d script at <A HREF="http://qmail.area.com/init.d-script" TARGET="_top" >http://qmail.area.com/init.d-script</A > If you have the Larry's init.d script just do this. <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="PROGRAMLISTING" > /etc/rc.d/init.d/qmail start</PRE ></FONT ></TD ></TR ></TABLE ></P ><P >Start VMailMgr daemon <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="PROGRAMLISTING" > /etc/rc.d/init.d/vmailmgrd start</PRE ></FONT ></TD ></TR ></TABLE ></P ><P >Start Courier-imap damon <TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="PROGRAMLISTING" > /etc/rc.d/init.d/courier-imap start</PRE ></FONT ></TD ></TR ></TABLE ></P ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="AEN418">3.6. Some considerations left</H2 ><P >Qmail and the Maildirs may cause some email apps that run locally to not work. Visit the Qmail website <A HREF="http://www.qmail.org" TARGET="_top" >http://www.qmail.org</A > for details on email apps that have been patched to work with Maildirs.</P ><P >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 <A HREF="http://www.inter7.com/courierimap/" TARGET="_top" >http://www.inter7.com/courierimap/</A >.</P ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="AEN424">3.7. Mail clients</H2 ><P >With the solution you should now have setup you will need to know that user accounts will be user@domain.com Netscape does not like this, so for netscape use user:domain.com</P ><P >I would like to suggest that you also checkout phpGroupWare at <A HREF="http://www.phpgroupware.org" TARGET="_top" >http://www.phpgroupware.org</A >. 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.</P ><P >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 <TT CLASS="LITERAL" >/usr/lib/courier-imap/etc/imapd</TT >.</P ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="AEN431">3.8. Known bugs</H2 ><P >None yet.</P ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="AEN434">3.9. The final word</H2 ><P >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!</P ><P >O.K. readers, you're done for today. Feel free to send me your feedback, eternal gratitude, flowers, ecash, cars, oil sources etc.</P ></DIV ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="x137.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" > </TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >Component installation</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" > </TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" > </TD ></TR ></TABLE ></DIV ></BODY ></HTML >