Commit | Line | Data |
---|---|---|
2117e02e MW |
1 | SAVE COPIES OF YOUR OUTGOING MAIL! Like any other piece of software (and |
2 | information generally), the qmail system comes with NO WARRANTY. It's | |
3 | much more secure and reliable than sendmail, but that's not saying much. | |
4 | ||
5 | ||
6 | Things you have to decide before starting: | |
7 | ||
8 | * The qmail home directory, normally /var/qmail. To change this | |
9 | directory, edit conf-qmail now. | |
10 | ||
11 | * The names of the qmail users and the qmail groups. To change these | |
12 | names, edit conf-users and conf-groups now. | |
13 | ||
14 | ||
212b6f5d | 15 | To create /var/qmail and configure qmail (won't interfere with sendmail): |
2117e02e MW |
16 | |
17 | 1. Create the qmail home directory: | |
18 | # mkdir /var/qmail | |
212b6f5d | 19 | |
2117e02e MW |
20 | 2. Read INSTALL.ids. You must set up the qmail group and the qmail |
21 | users before compiling the programs. | |
212b6f5d MW |
22 | |
23 | 3. Compile the programs and create the qmail directory tree: | |
24 | # make setup check | |
25 | ||
26 | 4. Read INSTALL.ctl and FAQ. Minimal survival command: | |
27 | # ./config | |
28 | ||
29 | 5. Read INSTALL.alias. Minimal survival command: | |
2117e02e MW |
30 | # (cd ~alias; touch .qmail-postmaster .qmail-mailer-daemon .qmail-root) |
31 | # chmod 644 ~alias/.qmail* | |
212b6f5d MW |
32 | |
33 | 6. Read INSTALL.mbox and INSTALL.vsm. | |
34 | ||
35 | 7. Read INSTALL.maildir. | |
36 | ||
37 | 8. Copy /var/qmail/boot/home (or proc) to /var/qmail/rc. | |
38 | ||
39 | ||
40 | To test qmail deliveries (won't interfere with sendmail): | |
41 | ||
42 | 9. Enable deliveries of messages injected into qmail: | |
43 | # csh -cf '/var/qmail/rc &' | |
44 | ||
45 | 10. Read TEST.deliver. | |
46 | ||
47 | ||
48 | To upgrade from sendmail to qmail: | |
49 | ||
50 | 11. Read SENDMAIL. This is what your users will want to know about the | |
51 | switch from sendmail to qmail. | |
52 | ||
53 | 12. Read REMOVE.sendmail. You must remove sendmail before installing | |
54 | qmail. | |
55 | ||
56 | 13. Read REMOVE.binmail. | |
57 | ||
58 | 14. Add | |
59 | csh -cf '/var/qmail/rc &' | |
60 | to your boot scripts, so that the qmail daemons are restarted | |
61 | whenever your system reboots. Make sure you include the &. | |
62 | ||
63 | 15. Make qmail's ``sendmail'' wrapper available to MUAs: | |
2117e02e | 64 | # ln -s /var/qmail/bin/sendmail /usr/lib/sendmail |
212b6f5d MW |
65 | # ln -s /var/qmail/bin/sendmail /usr/sbin/sendmail |
66 | /usr/sbin might not exist on your system. | |
67 | ||
68 | 16. Set up qmail-smtpd in /etc/inetd.conf (all on one line): | |
2117e02e | 69 | smtp stream tcp nowait qmaild /var/qmail/bin/tcp-env |
212b6f5d MW |
70 | tcp-env /var/qmail/bin/qmail-smtpd |
71 | ||
72 | 17. Reboot. (Or kill -HUP your inetd and make sure the qmail daemons | |
2117e02e | 73 | are running.) |
212b6f5d MW |
74 | |
75 | 18. Read TEST.receive. | |
76 | ||
2117e02e MW |
77 | |
78 | ||
79 | That's it! To report success: | |
212b6f5d MW |
80 | % ( echo 'First M. Last'; cat `cat SYSDEPS` ) | mail djb-qst@cr.yp.to |
81 | Replace First M. Last with your name. | |
82 | ||
83 | If you have questions about qmail, join the qmail mailing list; see | |
84 | http://pobox.com/~djb/qmail.html. |