debian/rules: Use `git' potty wrapper.
[qmail] / INSTALL
CommitLineData
2117e02e
MW
1SAVE COPIES OF YOUR OUTGOING MAIL! Like any other piece of software (and
2information generally), the qmail system comes with NO WARRANTY. It's
3much more secure and reliable than sendmail, but that's not saying much.
4
5
6Things you have to decide before starting:
7
8* The qmail home directory, normally /var/qmail. To change this
9directory, edit conf-qmail now.
10
11* The names of the qmail users and the qmail groups. To change these
12names, edit conf-users and conf-groups now.
13
14
212b6f5d 15To 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
40To 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
4510. Read TEST.deliver.
46
47
48To upgrade from sendmail to qmail:
49
5011. Read SENDMAIL. This is what your users will want to know about the
51 switch from sendmail to qmail.
52
5312. Read REMOVE.sendmail. You must remove sendmail before installing
54 qmail.
55
5613. Read REMOVE.binmail.
57
5814. 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
6315. 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
6816. 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
7217. Reboot. (Or kill -HUP your inetd and make sure the qmail daemons
2117e02e 73 are running.)
212b6f5d
MW
74
7518. Read TEST.receive.
76
2117e02e
MW
77
78
79That's it! To report success:
212b6f5d
MW
80 % ( echo 'First M. Last'; cat `cat SYSDEPS` ) | mail djb-qst@cr.yp.to
81Replace First M. Last with your name.
82
83If you have questions about qmail, join the qmail mailing list; see
84http://pobox.com/~djb/qmail.html.