Qmail VMailMgr and Courier-Imap HOWTO
Contents
1. 1 sre rpm http untroubled org ucspi unix e daemontools 0 70 3 src rpm http untroubled org rpms daemontools supervise scripts 3 3 1 src rpm http untroubled org supervise scripts e qmail 1 03 patches 18 sre rpm http untroubled org qmailt patches current e vmailmgr 0 96 9 1 sre rpm http www vmailmgr org current courier imap 1 4 3 tar gz http www inter7 com courierimap For Courier imap you must build the source rpm from the tar file instructions will follow 2 1 2 Get binary rpms Qmail does not come in binary form Such packages are explicitly disallowed by the author of Qmail and frustrating as it may be I understand his reasoning Courier imap does not come in binary form unless you want to use the one I built If you want mine visit http www clearrivertech com linux HOWTO supportfiles VMailMegr does not come in binary form that supports Courier imap unless you want to use the one I built If you want mine email me and I will send it ucspi tcp 0 88 1 1386 rpm http untroubled org rpms ucspi tcp ucspi unix 0 34 1 1386 rpm http untroubled org ucspi unix e daemontools 0 70 1 i1386 rpm http untroubled org rpms daemontools e supervise scripts 3 3 1 noarch rpm http untroubled org supervise scripts e qmail 1 03 patches 18 sre rpm http untroubled org qmail patches current e vmai2. e Switched the license to the GNU FDL e Other minor additions and corrections v1 5 March 11 2002 e Updated the Courier IMAP setup information for new VMailMegr version e Updated links to various websites e Other minor additions and corrections e Switched SGML from LinuxDOC to DocBook 1 10 Copyrights and Trademarks Copyright c Dan Kuykendall Permission is granted to copy distribute and or modify this document under the terms of the GNU Free Documentation License Version 1 1 or any later version published by the Free Software Foundation A copy of the license is available at GNU Free Documentation License 1 11 Acknowledgements and Thanks Thanks to everyone that gave comments as I was writing this This includes Bruce Guenter and other members of the vmailmgr discuss list 1 10 Copyrights and Trademarks 2 Component installation 2 1 Preparations You have two options e Get and compile source rpms This has the benefit of being able to review the source before compiling and compiling for your specific setup e Or simply get the binary rpms This has the benefit of simplicity and not having to worry about having the necessary libraries installed I recommend using Bruce Guenter s rpm releases since they are well patched and its what I used for building my systems 2 1 1 Get source rpms You will need e ucspi tcp 0 88 1 src rpm http untroubled org rpms ucspi tcp e ucspi unix 0 34
3. tar zxf supervise scripts 2 4 tar gz cd supervise scripts 2 4 2 2 1 Install with RPMS 7 Qmail VMailMgr and Courier lmap HOWTO configure make As root make setup check or make install 2 3 Install Qmail 2 3 1 Install with RPMS 2 3 1 1 Compiling SRC RPM s After installing the support packages Simply run the following command rpm rebuild lt package src rpm gt Example rpm rebuild qmail 1 03 patches 18 srce rpm 2 3 1 2 Installing RPM s After compiling the source rpms the binaries will be located in usr src redhat RPMS i386 or something similar Simply run the following command for the qmail package rpm ivh lt location gt lt package i386 rpm gt Example rpm ivh usr src redhat RPMS i386 qmail 1 03 patches 18 i386 rpm note start Remove sendmail and any dependant applications prior to installing Qmail by running the following command for each package rpm e lt packagename gt On my system I had to remove sendmail so I typed rpm e sendmail note end 2 3 2 Install with debs Run the following commands for each package as root dpkg i lt package deb gt Example Cloke a emieail il O3 17_ A386 clelo 2 3 3 Install with source Run the following command As non root user tar zxf lt package tar gz gt cd lt newly created dir gt Now read the INSTALL file and follow the steps to install Qmail Example 2 3 Install Qmail 8
4. Qmail VMailMgr and Courier lmap HOWTO As non root user tar zxf release 18 tar gz cd release 1 03 vi INSTALL Read and follow steps 2 4 Install Courier imap 2 4 1 Install with RPMS 2 4 1 1 Compiling SRC RPM s Build the courier imap rpms from the tar file rpm ta courier imap 1 4 3 tar gz note start This errors out if you compile as root but if your not root you wont have permissions to usr src redhat You will want to build as a non root user so create a rpmmacros file for rpm v3 and later in your home directory containing the line _topdir path to home redhat Then create your own redhat directory containing all the subdirs that usr src redhat contains You should never build RPMs as root unless you have to note end I will mention again that I have built the binaries and you can get them at http www clearrivertech com linux HOWTO supportfiles 2 4 1 2 Installing RPM s After compiling the source rpms the binary will be located in usr src redhat RPMS i386 or something similar Simply run the following command for each package rpm ivh lt location gt lt package i386 rpm gt Example rpm ivh usr src redhat RPMS i386 courier imap 1 4 3 i386 rpm 2 4 2 Install with debs Run the following commands for each package as root apt get lt package deb gt Example apt get courier imap 2 4 3 Install with source Run the following
5. NEATE IATE NE ETE ETIE S AET EAA T E E E T TA T R ENT 13 o MI TE DUES aa ia nousaaes i seat upueeeeantanceca raucous mancuaniedt 13 1 Introduction Qmail VMailMgr and Courier IMAP are a very powerful and easy to use solution but they are not what I would consider easy to setup I hope this document helps with that 1 1 What is Qmail and why should I use it Here is the authors Dan Bernstein blurb Qmail is a secure reliable efficient simple message transfer agent It is meant as a replacement for the entire sendmail binmail system on typical Internet connected UNIX hosts It offers POP3 and IMAP with the help of Courier I MAP so that you can use any mail client you prefer Secure Security isn t just a goal but an absolute requirement Mail delivery is critical for users it cannot be turned off so it must be completely secure This is why I started writing qmail I was sick of the security holes in sendmail and other MTAs Reliable qmail s straight paper path philosophy guarantees that a message once accepted into the system will never be lost qmail also supports maildir a new super reliable user mailbox format Maildirs unlike mbox files and mh folders won t be corrupted if the system crashes during delivery Even better not only can a user safely read his mail over NFS but any number of NFS clients can deliver mail to him at the same time Efficient On a Pentium under BSD OS qmail can easily sustain 2
6. as is normal with qmail and VMailMgr domainl com userl For more detailed setup and config documentation visit the Qmail website http Awww qmail org and the VMailMer website http www vmailmgr org 3 2 Tell Qmail to use VMailMgr for authentication By default qmail uses checkpassword for authentication to tell Qmail to use VMailMegr for authentication type the following command echo checkvpw gt var qmail control checkpassword 3 3 Setup Courier imap for VMailMgr Copy the VMailMegr 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 authvmailmegr as the only 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 VWeelup 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 VMailMer website http www vmailmegr org 3 Putting it all together 12 Qmail VMailMgr and Courier lmap HOWTO 3 5 Starting the daemons Starting the Qmail
7. command As non root user tar zxf lt package tar gz gt cd lt newly created dir gt configure make As root make install 2 4 Install Courier imap 9 Qmail VMailMgr and Courier lmap HOWTO Example As non root user EGS ASE courier map MA Jee gz cd courier imap 1 4 3 configure make As root make install 2 5 Install VMailMgr 2 5 1 Install with RPMS 2 5 1 1 Compiling SRC RPM s There is a problem compliling VMailMGR on RedHat 7 x distros and maybe other new ones as well To solve this you must edit the source files These files need to have an include lt string h gt added lib misc exec cc lib misc keystrlist cc o m Heil ase ee lib mystring append cc authenticate authvmailmgr cc The following needs to have an include lt stdlib h gt authenticate vauthenticate cc authenticate checkvpw cc The copies I have on http www clearrivertech com linux HOWTO supportfiles rh72 are already patched Simply run the following command rpm rebuild lt package src rpm gt Example join welouililel waayeial lmeie 0 96 Gai See iejouin 2 5 1 2 Installing RPM s If you compiled the source rpm the binaries will be located in usr src redhat RPMS i386 or something similar Simply run the following command for each package rpm ivh lt location gt lt package i386 rpm gt Example rpm ivh usr src redhat RPMS i386 vmailmgr 0 96 9 1 1386 rpm rpm ivh
8. daemon Qmail installs itself to autostart by some mysterious to me way If you like init scripts you can get Larry Doolittle s Idoolitta ajlab org init d script at http qmail area com init d script If you have the Larry s init d script just do this eee Gena init c cmail start Start VMailMgr daemon etc re d init d vmailmgrd start Start Courier imap damon etc re 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 Mail clients 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 I would like to suggest that you also checkout phpGroup Ware 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
9. 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 3 8 Known bugs None yet 3 5 Starting the daemons 13 Qmail VMailMgr and Courier Ilmap HOWTO 3 9 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 3 9 The final word 14
10. package rrena a E EEE TOE E E SE veravereioueaaney 6 2 14 Get tarred sources for HOM KR PM WSEES scsisns ccssvins savevavsvdeanivces unisi E rie viinnevebatansededsekeves 6 ERA TET S A ASE Re A A A sea guataear tea eet innate saad enaua ne pe Raa ee 6 rN GV E Ol i n q Be rae 2 MIME U Sart UID CIC e E E RE E E E E E E TA E E TA a BT IU BOIS soaer ce ue ci pai ehdp tar anni aha Doan Tk nti BT AIT T Ze SiON te sccn cue Gis ply Gaal eed de va jana ean ty eka Pata gna ed pa Paced paw ed puaes mes panne Sean oer ATE eTEeoed 8 BN ADD SU REN oE a dat uci dantaondaainnadaer E AE 8 232 lasal ye DE ea a azuonssedeadessdonl sosaannvennsuon sseavereaseeonitc 8 PAE Be TI EA BIC E AEEA A EEE E A E A E 8 PE DA EE T E EE AT AEE I E E A A E O OA OEE 9 t a VRE PN ear a a ua ank uae aaseamanneaaoeee 9 2a N a E e i 9 PA e I EA EN a E E E E E S E alae E A A I Oo 9 PS A EA L a E E E A E E E A E A A E A 10 sd DAD ee eana a aa 10 232 laia CO OR r E 11 SE UN EA PMID os oe cians sxe besa EE kat aes A oa eH nO TRIER Rae 11 A Pulling E all togethers oie duane O I aA E aAA EANNAN A 12 3 1 Basic Omal conii renren ERr E a 12 3 2 Vell Qmail to pee VMailMer tor aptheniicantomy cccsiuiacasiiadienunonseniGagrae aan 12 32 setup Comer imiap for VMalMeE sereen ii EA A plas EE AR EA EE KA EAEE 12 34 Setup Mata Conan with Ya siccae iniiaiee aT A Eii 12 2a SAn ha daemon errr rr a O OEE NEE rE rE NEEE R O ETERS 13 EKME AE E AELE e i AA A A A E ANE EE EE 13 EE E TC 0 E E A EA
11. usr src redhat RPMS i386 VMailMgr daemon 0 96 6 1 1386 rpm rpm ivh usr src redhat RPMS i386 vmailmgr courier imap 0 96 9 2 i386 rpm 2 5 Install VMailMgr 10 Qmail VMailMgr and Courier Ilmap HOWTO 2 5 2 Install with debs Run the following commands for each package as root dpkg i lt package deb gt Example Cloke i Wane linge 0 9 H 386 6lelo 2 5 3 Install with source There is a problem compliling VMailMGR on RedHat 7 x distros and maybe other new ones as well To solve this you must edit the source files These files need to have an include lt string h gt added lib misc exec cc lib misc keystrlist cc Tio misce strlistCe lib mystring append cc authenticate authvmailmgr cc The following needs to have an include lt stdlib h gt authenticate vauthenticate cc authenticate checkvpw cc The copies I have on http www clearrivertech com linux HOWTO supportfiles rh72 are already patched Run the following commands As non root user tar zxf lt package tar gz gt cd lt newly created dir gt configure make As root make install Example As non root user EGS MARE vnelo SO Y ieee ez cd vmailmgr 0 96 9 configure make As root make setup check or make install That should do it 2 5 2 Install with debs 11 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
12. 00000 local messages per day that s separate messages injected and delivered to mailboxes in a real test Although remote deliveries are inherently limited by the slowness of DNS and SMTP qmail overlaps 20 simultaneous deliveries by default so it zooms quickly through mailing lists This is why I finished qmail I had to get a big mailing list set up Simple qmail is vastly smaller than any other Internet MTA Some reasons why 1 Other MTAs have separate forwarding aliasing and mailing list mechanisms qmail has one simple forwarding mechanism that lets users handle their own mailing lists 2 Other MTAs offer a spectrum of delivery modes from fastt unsafe to slow queued qmail send is instantly triggered by new items in the queue so the qmail system has just one delivery mode fast queued 3 Other MTAs include in effect a specialized version of inetd that watches the load average qmail s design inherently limits the machine load so qmail smtpd can safely run from your system s inetd Replacement for sendmail qmail supports host and user masquerading full host hiding virtual domains null clients list owner rewriting relay control double bounce recording arbitrary RFC 822 address lists cross host mailing list loop detection per recipient checkpointing downed host backoffs independent message retry schedules etc In short it s up to speed on modern MTA features qmail also includes a drop in sendmail wrapp
13. Qmail VMailMgr and Courier Imap HOWTO Dan Kuykendall lt dan kuykendall org gt v1 5 12 March 2002 This document is about building a mail server that will support virtual domain hosting and provide smtp pop3 and imap services using a powerful alternative to sendmail Qmail VMailMgr and Courier Ilmap HOWTO Table of Contents SB aia A RESE PEPE ETEA IAEA OEE ER RN BE IEEE stand eee EAA AE EEEE ET 1 11 What is Omail and why should use M s csssiscccisicasdivenserapssnerwad boavdeneasauedsousaeersoineensasacnonsatewnversavonees 1 1 2 What is VMailMer and why should Luse 10 oesrssniissnsininisienoie si nikkie niokeen ide kioii 1 13 What is Cower imap and why should use itl ccijsns cess sxe vecsiuacnch saaaeneasniscraouneecestasseesouis vas suderetiadacke 2 Ta Desciption of thie Bias ICS rapen RATE REEE AONE t 2 15 Working conigurit oBer n a a a E mie 3 Ui a i E a ETANTE AE TAA E E E EA oA E A A EA 3 AE UN E A A E ET EE PA PE AE R EE P ae A EA E T 3 ES RE I E AEE E E EE One A EAA EA AR er I T A Gur errr T E 3 O Version HINO sisecsssiee catsnsdvasesvsencnsssenanedeaausscootesanesdunnnsossnce E OOE E A rE 3 LIO Copyrighti and Troienii KES eatae ERAEN aN AAE el EANNAN AAR 4 LIL Aciovledremenis and GAS oss css acorn an ET N EADIE on RG aden 4 2 COME AE TiS Coa oe vacccia sndaccocccicbciiveencoensbcnvcoss wot R A 5 A A ens nae cha TL ae aT 5 PA A E Neh SMS DIN 528s pa E E E peewee A ates pete 5 e ret Be aa a aa alanine 5 Del So Get deb
14. aikel Wesjor wMIx 0 34 i1 See Keul Gon EoD lelicecdaemome olls Orm OS mS CEON rpm rebuild supervise scripts 3 3 l sre rpm You may get dependancy errors If you do then install the package that is being requested using the steps below This may happen when you compile daemontools before installing ucspi tcp 2 2 1 2 Installing RPM s If you compiled the source rpms the binaries will be located in usr src redhat RPMS i386 or something similar Simply run the following command for each package rpm ivh lt location gt lt package i386 rpm gt Example rpm ivh usr src redhat RPMS i386 ucspi tcp 0 88 1 1386 rpm rpm ivh usr src redhat RPMS i386 ucspi unix 0 34 1 1386 rpm rpm ivh usr src redhat RPMS i386 daemontools 0 70 3 i386 rpm rpm ava usr src redhat RPMS i386 supervise scripts 3 3 1 1386 rpm 2 2 2 Install with debs Run the following commands for each package as root dpkg i lt package deb gt Example dpkgp el csp tepm Onc o gt smo Ode CGO KG ucsot viais Q oA SEG Ce dpkg i daemontools_0 70 1_i386 deb dpkg i supervise scripts_3 3 6_i386 deb 2 2 3 Install with source Run the following commands for each package As non root user tar zxf lt package tar gz gt cd lt newly created dir gt configure make As root make setup check for ucspi tcp and daemontools or make install for ucspi unix and supervise scripts Example As non root user
15. er so that it will be used transparently by your current UAs 1 2 What is VMailMgr and why should I use it VMailMe gr is 1 Introduction 1 Qmail VMailMgr and Courier Ilmap HOWTO A password checking interface between qmail popup and qmail pop3d which replaces the usual checkpassword as well as an authentication module for Courier IMAP that provide access to the virtual mailboxes by one of three methods e P based virtual server access invisible to the POP3 user username based access username virtualuser e hostname based access virtualuser virtual host or virtualuser virtual host You should use it if You prefer to have the users manage their own domains email accounts and store their email in their own home dir This makes setting up disk space quotas much easier 1 3 What is Courier imap and why should I use it Courier IMAP is A server that provides IMAP access to Maildir mailboxes This IMAP server does NOT handle traditional mailbox files var spool mail and derivatives it was written for the specific purpose of providing IMAP access to Maildirs You should use it because By default Qmail uses the newer more efficient Maildir format for storing email and Courier imap is the only imap server I am aware of that supports Maildir So in short if you use Qmail and want imap support you have to use it 1 4 Description of the components The email system you hopefully will get after
16. hare runtime collective com berkan debian dists woody misc binary i386 e qmail_1 03 17_i386 deb http bagic net billy debs qmail 1 03 17 e vmailmgr_0 96 9 3_i386 deb http bagic net billy debs vmailmegr e courier imap apt get courier imap 2 1 4 Get tarred sources for non RPM users If your system does not have or you do not use RPMS you can install from source e ucspi tcp 0 88 tar gz http cr yp to ucspi tcp ucspi unix 0 34 tar gz http untroubled org ucspi unix e daemontools 0 70 tar gz http cr yp to daemontools supervise scripts 3 3 tar gz http untroubled org supervise scripts e qmail release 18 tar gz http untroubled org qmail patches current e vmailmgr 0 96 9 tar gz http www vmailmgr org current courier imap 1 4 3 tar gz http www inter7 com courierimap There may be minor differences in these instructions due to the use of the standard Qmail package Please review the documentation for Qmail and VMailMgr if any of the files deviates from my instructions 2 2 Install support packages 2 1 3 Get deb packages Qmail VMailMgr and Courier lmap HOWTO 2 2 1 Install with RPMS 2 2 1 1 Compiling SRC RPM s Simply run the following command for each package rpm rebuild lt package src rpm gt Example Wom welowslilel Wesjoi ctcoO 0 S8 il sice om iqom celow
17. having read this HOWTO is composed of several parts the patched Qmail rpms are key to using this document I recommend using the software versions I tried they will probably compile without many problems and result in a fairly stable daemon If you are courageous you can try to compile all the latest stuff with tons of new features but don t blame me if something fails However you may report other working configurations to be included in future versions of this document All of the steps were tested on a RedHat Linux 7 2 box so the HOWTO is somewhat specific but you should be able to use it for other linux distributions as well You do not necessarily have to install in all components I tried to structure this HOWTO so that you can skip the parts you are not interested in The document is neither a user manual to Qmail VMailMegr nor Courier imap Its prime intention is to save email admins some headaches when installing their server and to do my little contribution to the linux community 1 3 What is Courier imap and why should use it 2 Qmail VMailMgr and Courier lmap HOWTO 1 5 Working configurations Though this document is only able to cover a snapshot in time on a limited number of setups I am pretty confident that it can help you get your email system up and running Combinations that work for me are e RedHat 7 2 Qmail 1 03 patches 18 VMailMer 0 96 9 Courier imap 1 4 3 e RedHat 6 2 Linux 2 2 14 Qma
18. il 1 03 patches 12 VMailMer 0 96 6 Courier imap 0 31 e Mandrake 7 0 Linux 2 2 13 Qmail 1 03 patches 12 VMailMer 0 96 6 Courier imap 0 31 e Debian Potato Qmail 1 03 VMailMer 0 96 9 Courier imap 1 4 3 1 6 History This document was started on April 18 2000 by Dan Kuykendall after several installs of Qmail and VMailMer Then even more setups when Courier imap support was ready 1 7 New versions The newest version of this can be found on my homepage http www clearrivertech com linux HOWTO as SGML source as HTML and as TEXT Other versions may be found in different formats at the LDP homepage http www linuxdoc org 1 8 Comments Comments on this HOWTO may be directed to the author Dan Kuykendall dan kuykendall org 1 9 Version History v0 1 April 18 2000 e Preview version wasn t in HOWTO format v1 0 April 18 2000 e Minor corrections e Added details and put into HOWTO format v1 1 April 19 2000 e Minor corrections e Restructured RPM install step e Added source compile and install steps v1 2 April 19 2000 1 5 Working configurations Qmail VMailMgr and Courier lmap HOWTO e Minor corrections e Fixed source compile locations and install steps e Added source compile and install steps v1 3 April 19 2000 e Minor corrections e Built proper SGML version using LinuxDoc DTD v1 4 April 23 2000 e Updated the Courier IMAP setup information for new VMailMegr version
19. lmgr 0 96 9 2 1386 rpm http www vmailmegr org current e vmailmgr courier imap 0 96 9 2 1386 rpm http www vmailmgr org current courier imap 1 4 3 tar gz http www inter7 com courierimap For qmail you must always compile yourself due to the license restrictions For Courier imap you must 2 Component installation 5 Qmail VMailMgr and Courier lmap HOWTO build the binary rpm from the tar file instructions will follow or email me for my binary rpm 2 1 3 Get deb packages There are multiple locations for qmail and vmailmgr deb packages Courier imap is part of the normal debian applications You can get them in the following locations e http bagic net billy debs by Hon billy bagic net e http www tet dk by Ole Barnkob Kaas admin tet dk http smarden org pape Debian by Gerrit Pape pape smarden org The packages by Hon are current and even include support for courier imap which was a great help for me so Iam going to use a combination of them for my examples You can of course choose the ones you want for yourself but your results may vary You will need e ucspi tcp_0 88 3_1386 deb http bagic net billy debs ucspi tcp 0 88 3 e ucspi unix_0 34 1_1386 deb http bagic net billy debs ucspi unix e The latest daemontools from http smarden org pape Debian daemontools html supervise scripts_3 3 6_i1386 deb http s
Download Pdf Manuals
Related Search