masqmail

view INSTALL @ 166:0ef0f756280b

moved the PPP setup documentation from INSTALL to an own file
author meillo@marmaro.de
date Thu, 08 Jul 2010 22:02:58 +0200
parents 5b621742b2e7
children 25b769efafe6
line source
1 Additional information may be available in docs/ or on the website.
2 For installing on GNU/Linux distributions read docs/linux-distris.
5 Installation instructions
6 -------------------------
8 To compile masqmail you need glib (>= 1.2) (http://www.gtk.org). Your
9 distribution probably provides it.
11 You need a user and a group for masqmail to run. If
13 grep '^mail:' /etc/passwd
14 grep '^trusted:' /etc/group
16 shows that the user `mail' and the group `trusted' exist, it's
17 probably best to use these. If they don't exist, create them:
19 groupadd -g 42 trusted
20 useradd -u 23 -g 42 -d / -s /bin/sh -c "Mail Transfer Agent" mail
22 If you use other names than `mail' and `trusted' use the options
23 described below for configure. The 23 and 42 are just a suggestion,
24 you can use any (not yet used) number you like, but preferably one
25 lower than 100. It does not have to be the same for the user `mail'
26 and the group `trusted'.
29 Compliling is a matter of the usual procedure. In the source directory,
30 after unpacking do:
32 ./configure
33 make
34 make install
38 Additional options for configure
39 --------------------------------
41 See the output of
43 ./configure -h
45 Here is a selection of the options with additional explanations:
47 --with-user=USER
48 sets the user as which masqmail will run. Default is 'mail'. USER has
49 to exist before you 'make install'.
51 --with-group=GROUP
52 sets the group as which masqmail will run. Default is 'trusted'. GROUP
53 has to exist before you 'make install'.
56 --with-logdir=LOGDIR
57 sets the directory where masqmail stores its log files. It will be
58 created if it does not exist. Default is /var/log/masqmail/.
60 --with-spooldir=SPOOLDIR
61 sets the directory where masqmail stores its spool files. It will be
62 created if it does not exist. Default is /var/spool/masqmail/.
64 --with-confdir=CONFDIR
65 sets the default configuration directory to CONFDIR, in case you
66 prefer another location than /etc/masqmail/.
69 --enable-auth
70 enables ESMTP AUTH support (disabled by default)
72 --enable-maildir
73 enables qmail style Maildir support (disabled by default)
75 --enable-ident
76 enable RFC 1413 support. If you have the libident dynamic library
77 installed, this will be linked, otherwise it will be statically linked
78 using the sources included in the package.
80 --enable-pop3
81 enables pop3 support (disabled by default)
83 --disable-resolver
84 disable resolver support. Without the resolver functions, masqmail
85 uses only gethostbyname() to resolve DNS names, and you cannot send
86 mail without a smart host. Not recommended.
88 --disable-smtp-server
89 disable SMTP server support. You may want this if you do not need
90 masqmail to listen. In this case, you cannot use masqmail as a smart
91 host for other hosts on your LAN, you cannot use mail clients that
92 send SMTP, you cannot even use pine. In short, use of this option is
93 discouraged unless your resources are extremely limited.
96 --with-libcryto
97 instead of using the md5 and hmac functions within the package, link
98 dynamically with libcrypto. This applies only if you have pop3 or SMTP
99 AUTH enabled. Makes only sense if your resources are limited and you
100 have libcrypto installed. Untested.
102 --with-glib-static
103 link with glib statically. This makes the binary larger by around 30K
104 (i386 architecture), but if masqmail is the only binary using glib,
105 you save some space in total, because you do not need the shared glib
106 library installed.
109 --disable-debug
110 disable debugging, setting it on by command line or configuration has
111 no effect. Strongly discouraged, since you miss valuable information
112 if something goes wrong.
116 Checking the installation
117 -------------------------
119 Check that 'make install' worked correctly. The following command:
121 ls -ld /usr/local/sbin/masqmail /etc/masqmail /var/log/masqmail/ \
122 /var/run/masqmail /var/spool/masqmail/ /var/spool/masqmail/*
124 should give output similar to
126 -rwsr-xr-x 1 root root 399356 May 10 12:34 /usr/local/sbin/masqmail
127 drwxr-xr-x 2 root root 4096 May 10 12:34 /etc/masqmail
128 drwxr-xr-x 2 mail trusted 4096 May 10 12:34 /var/log/masqmail
129 drwxr-xr-x 2 mail trusted 4096 May 10 12:34 /var/run/masqmail
130 drwxr-xr-x 5 mail trusted 4096 May 10 12:34 /var/spool/masqmail
131 drwxr-xr-x 2 mail trusted 4096 May 10 12:34 /var/spool/masqmail/input
132 drwxr-xr-x 2 mail trusted 4096 May 10 12:34 /var/spool/masqmail/lock
133 drwxr-xr-x 2 mail trusted 4096 May 10 12:34 /var/spool/masqmail/popuidl
135 Important are the set-user-id bit for /usr/local/sbin/masqmail and
136 the permissions of all files.
140 Making masqmail the default
141 ---------------------------
143 `sendmail' is the de-facto standard name of the system's MTA, no
144 matter which MTA actually runs. If you want to make masqmail the
145 system's MTA (i.e. replace sendmail, postfix, etc), make a symbolic
146 link:
148 ln -s /usr/local/sbin/masqmail /usr/lib/sendmail
150 Now every mailer that used to call sendmail will now call masqmail.
151 If you already had an MTA installed and running, you can kill it and
152 start masqmail. Probably with:
154 /etc/init.d/sendmail restart
156 If this doesn't work as expected, you might need to add a special init
157 script for masqmail. Currently none is distributed with masqmail.
158 (Hopefully this will change soon.) Please ask on the mailing list for
159 help.
161 You can also directly start masqmail as daemon with:
163 /usr/local/sbin/masqmail -bd -q30m
167 Basic Configuration
168 -------------------
170 The only thing you must configure in order to use masqmail is the
171 hostname. It's the name under which masqmail operates. In most cases
172 it is the same as the machine's name, but it can be different.
174 The script `contrib/guess-hostname' tries to print the hostname of
175 your machine. The first output line is probably the best choice.
177 Create a minimal config with:
179 echo "host_name = HOSTNAME" >/etc/masqmail/masqmail.conf
181 (Substitute `HOSTNAME' with the real value, of course.)
183 Such a setup (i.e. the default one) does:
184 - deliver mail locally
185 - accept mail from local (via stdin)
186 - accept mail on localhost:25 (via SMTP)
187 It does not
188 - transfer any mail to other machines
189 - accept mail from outside your machine
192 For more elaborate setups, have a look at docs/*setup and
193 docs/INSTALL*. You can also take the example configuration files in
194 examples/ as basis for your own. Take the man pages masqmail.conf(5)
195 and masqmail.route(5) for reference.
197 All configuration files should go into /etc/masqmail.
201 Written by oku.
202 Improved by meillo.