summaryrefslogtreecommitdiff
path: root/mail/qmail/files/PORT_NOTES
blob: 6c2928c273831f11aa917d3ca841d8d4a5964b65 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
This text was originally taken from the qmail INSTALL file that you
will find in /var/qmail/doc/.  In addition to INSTALL, there are many
other potentially important qmail documents there.

As with all ports, the ports maintainer (me!) makes NO WARRANTIES of
any kind: expressed, implied, or other; about the reliability or
security of this package.  Any damage or problems derived from its
usage or related to it are neither my responsibility nor the software
author's.  This package is provided AS IS.

Although I am probably sounding cold and harsh, believe me: qmail is
one of the most reliable and easy-to-use softwares around.  However,
this also is NOT a WARRANTY.  It is just an opinion.  :)

The qmail port will normally install into /var/qmail/.  If you changed
this to /usr/local/, then please note that the docs have been
installed into /usr/local/share/doc/qmail/ (as opposed to
/usr/local/doc/).

If you wish to rerun the automatic configuration utility, do:

# cd /var/qmail/configure ; ./config

If you are upgrading from a previous version of qmail, you should read
/var/qmail/doc/UPGRADE and follow all the steps after #6.


[from /var/qmail/doc/INSTALL]

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.

[pre-build instructions elided]

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

[#1 - #3 elided]

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

[The "minimal" command has already been performed.]

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

[The "minimal" command has already been performed.]

 6. Read INSTALL.mbox and INSTALL.vsm.

 7. Read INSTALL.maildir.

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

[When you do this, qmail will be started automatically the next time
 you boot.  This is because the command
 ``ln -s /var/qmail/rc /usr/local/etc/rc.d'' has been executed.  There
 is a number of sample bootfiles provided.  Not all of them will work.]

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.

[Do not disable sendmail as instructed in REMOVE.sendmail step #1.
 Instead, change the sendmail_enable line in /etc/rc.conf to read

        sendmail_enable="NO"
 ]

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 &.

[Do not do this.  Unless you remove the symlink
 /usr/local/etc/rc.d/qmail.sh, the script /var/qmail/rc will be run
 everytime you boot.  See also "local_startup" in /etc/rc.conf.]

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

[A freshly-updated /etc/inetd.conf will have a sample qmail entry that
 you can simply uncomment.]

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 /var/qmail/doc/SYSDEPS ) \
		| mail djb-qst@cr.yp.to
Replace First M. Last with your name.

[Note that "cat `cat SYSDEPS`" has changed to "cat /var/qmail/doc/SYSDEPS"]

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