Q-Mail - Howto
- Author: zartik
- File Information: This text document may be copied, deleted, and published as desired provided credit is given to the author. If any alterations are made, each and every change must be commented as change to the original document, thank you.
- Purpose: Provide a 1,2,3 setup guide to qmail.
Welp, if you are reading this and setting up qmail on a production server ... eek. This is intended as a 2 minute guide to install a basic qmail setup with pop3 access on a freebsd machine. I explain it assuming you want to use the Maildir method implemented by qmail. This document is just going to tell you the how's of it, for the why's and much more information please read the documents in the /var/qmail/doc directory or visit www.qmail.org .
This is going to be simple, since FreeBSD comes with that nice little section called ports. As with all ports, type make install in the following
Tough, huh? The installs for these really set just about everything up for you.
The only things left are to add this line to /etc/inetd.conf, and make sure you put it all on one line, I broke it up due to it's length:
pop3 stream tcp nowait root /var/qmail/bin/qmail-popup
qmail-popup spot.org /bin/checkpassword
For every user you want to have mail, you need to run the fancy
little maildirmake utility. Here is an example:
My current home directory is: /usr/home/zartik
Now to add maildir to it, do: /var/qmail/bin/maildirmake /usr/home/zartik/Maildir
And then: echo ./Maildir/ > .qmail
Last step, select your 'rc' file, this is to start qmail when you boot.
cp /var/qmail/boot/maildir /var/qmail/rc
You need to make sure /var/qmail/bin is in the path on startup or else qmail won't start properly. Your other option is to edit /var/qmail/rc now and put
the path /var/qmail/bin before qmail-start in the file. Now just type:
killall -HUP inetd
csh -cf '/var/qmail/rc &'
Congrats, qmail is up and running and you will be recieving mail from all your favorite online relatives.