debian/rules: Use `git' potty wrapper.
[qmail] / INSTALL.alias
CommitLineData
2117e02e
MW
1qmail lets each user control all addresses of the form user-anything.
2Addresses that don't start with a username are controlled by a special
3user, alias. Delivery instructions for foo go into ~alias/.qmail-foo;
4delivery instructions for user-foo go into ~user/.qmail-foo. See
212b6f5d 5dot-qmail.0 for the full story.
2117e02e
MW
6
7qmail doesn't have any built-in support for /etc/aliases. If you have a
212b6f5d
MW
8big /etc/aliases and you'd like to keep it, install the fastforward
9package, available separately. /etc/aliases should already include the
10aliases discussed below---Postmaster, MAILER-DAEMON, and root.
2117e02e
MW
11
12If you don't have a big /etc/aliases, you'll find it easier to use
13qmail's native alias mechanism. Here's a checklist of aliases you should
14set up right now.
15
16* Postmaster. You're not an Internet citizen if this address doesn't
17work. Simply touch (and chmod 644) ~alias/.qmail-postmaster; any mail
18for Postmaster will be delivered to ~alias/Mailbox.
19
20* MAILER-DAEMON. Not required, but users sometimes respond to bounce
21messages. Touch (and chmod 644) ~alias/.qmail-mailer-daemon.
22
23* root. Under qmail, root never receives mail. Your system may generate
24mail messages to root every night; if you don't have an alias for root,
25those messages will bounce. (They'll end up double-bouncing to the
26postmaster.) Set up an alias for root in ~alias/.qmail-root. .qmail
27files are similar to .forward files, but beware that they are strictly
28line-oriented---see dot-qmail.0 for details.
29
30* Other non-user accounts. Under qmail, non-user accounts don't get
31mail; ``user'' means a non-root account that owns ~account. Set up
32aliases for any non-user accounts that normally receive mail.
33
34Note that special accounts such as ftp, www, and uucp should always have
35home directories owned by root.
36
37* Default. If you want, you can touch ~alias/.qmail-default to catch
38everything else. Beware: this will also catch typos and other addresses
39that should probably be bounced instead. It won't catch addresses that
40start with a user name---the user can set up his own ~/.qmail-default.