SAVE COPIES OF YOUR OUTGOING MAIL! Like any other piece of software (and
information generally), the qmail system comes with NO WARRANTY. It's
much more secure and reliable than sendmail, but that's not saying much.


Things you have to decide before starting:

* The qmail home directory, normally /var/qmail. To change this
directory, edit conf-qmail now.

* The names of the qmail users and the qmail groups. To change these
names, edit conf-users and conf-groups now.


To create /var/qmail and configure qmail (won't interfere with sendmail):

1. Create the qmail home directory:
# mkdir /var/qmail

2. Read INSTALL.ids. You must set up the qmail group and the qmail
users before compiling the programs.

3. Compile the programs and create the qmail directory tree:
# make setup check

4. Read INSTALL.ctl and FAQ. Minimal survival command:
# ./config

5. Read INSTALL.alias. Minimal survival command:
# (cd ~alias; touch .qmail-postmaster .qmail-mailer-daemon .qmail-root)
# chmod 644 ~alias/.qmail*

6. Read INSTALL.mbox and INSTALL.vsm.

7. Read INSTALL.maildir.

8. Copy /var/qmail/boot/home (or proc) to /var/qmail/rc.


To test qmail deliveries (won't interfere with sendmail):

9. Enable deliveries of messages injected into qmail:
# csh -cf '/var/qmail/rc &'

10. Read TEST.deliver.


To upgrade from sendmail to qmail:

11. Read SENDMAIL. This is what your users will want to know about the
switch from sendmail to qmail.

12. Read REMOVE.sendmail. You must remove sendmail before installing
qmail.

13. Read REMOVE.binmail.

14. Add
csh -cf '/var/qmail/rc &'
to your boot scripts, so that the qmail daemons are restarted
whenever your system reboots. Make sure you include the &.

15. Make qmail's ``sendmail'' wrapper available to MUAs:
# ln -s /var/qmail/bin/sendmail /usr/lib/sendmail
# ln -s /var/qmail/bin/sendmail /usr/sbin/sendmail
/usr/sbin might not exist on your system.

16. Set up qmail-smtpd in /etc/inetd.conf (all on one line):
smtp stream tcp nowait qmaild /var/qmail/bin/tcp-env
tcp-env /var/qmail/bin/qmail-smtpd

17. Reboot. (Or kill -HUP your inetd and make sure the qmail daemons
are running.)

18. Read TEST.receive.



That's it! To report success:
% ( echo 'First M. Last'; cat `cat SYSDEPS` ) | mail djb-qst@cr.yp.to
Replace First M. Last with your name.

If you have questions about qmail, join the qmail mailing list; see
http://pobox.com/~djb/qmail.html.