Upstream qmail 1.01
[qmail] / INSTALL.ctl
1 As you've seen, qmail has essentially no pre-compilation configuration.
2 You should never have to recompile it unless you want to change the
3 qmail home directory, usernames, or uids.
4
5 qmail does allow quite a bit of easy post-installation configuration. If
6 you care how your machine greets other machines via SMTP, for example,
7 you can put an appropriate line into /var/qmail/control/smtpgreeting.
8
9 But this is all optional---if control/smtpgreeting doesn't exist, qmail
10 will do something reasonable by default. You shouldn't worry much about
11 configuration right now. You can always come back and tune things later.
12
13 There's one big exception. You MUST tell qmail your hostname. The easy
14 way to do this is to run the qmail-config script:
15
16 # ./qmail-config
17
18 qmail-config finds your fully-qualified hostname in DNS and puts it into
19 control/me. It also selects good defaults for a few other controls.
20
21 (Why doesn't qmail do these lookups on the fly? This was a deliberate
22 design decision. qmail does all its local functions---header rewriting,
23 checking if a recipient is local, etc.---without talking to the network.
24 The point is that qmail can continue accepting and delivering local mail
25 even if your network connection goes down.)
26
27 Next, read through FAQ for information on setting up optional features
28 like masquerading. If you really want to learn right now what all the
29 configuration possibilities are, see qmail-control.0.