Mercurial > masqmail
annotate INSTALL @ 322:01d2f7a17bf0
hinted that the debug output of folded headers prints only the
first line
| author | meillo@marmaro.de |
|---|---|
| date | Fri, 03 Jun 2011 09:40:03 +0200 |
| parents | cab46cefa4ce |
| children | 92340177150d |
| rev | line source |
|---|---|
| 59 | 1 Additional information may be available in docs/ or on the website. |
|
174
dbe3dadd1afe
Documentation improvements in the INSTALL file and some man pages
meillo@marmaro.de
parents:
92
diff
changeset
|
2 For installing on GNU/Linux distributions read docs/INSTALL.linux. |
| 59 | 3 |
| 0 | 4 |
| 59 | 5 Installation instructions |
| 6 ------------------------- | |
| 7 | |
| 165 | 8 To compile masqmail you need glib (>= 1.2) (http://www.gtk.org). Your |
|
181
8b17ea9fd17b
added comments on how to compile with glib-1.2
meillo@marmaro.de
parents:
175
diff
changeset
|
9 distribution probably provides it. Glib-2.0 works out of the box, for |
|
8b17ea9fd17b
added comments on how to compile with glib-1.2
meillo@marmaro.de
parents:
175
diff
changeset
|
10 glib-1.2, you need to adjust configure.ac. See the comment in there. |
| 165 | 11 |
| 12 You need a user and a group for masqmail to run. If | |
| 0 | 13 |
| 165 | 14 grep '^mail:' /etc/passwd |
| 15 grep '^trusted:' /etc/group | |
| 16 | |
| 17 shows that the user `mail' and the group `trusted' exist, it's | |
| 18 probably best to use these. If they don't exist, create them: | |
| 0 | 19 |
| 59 | 20 groupadd -g 42 trusted |
|
194
346955794084
specified group by name; added path to --with-glib-static
meillo@marmaro.de
parents:
192
diff
changeset
|
21 useradd -u 23 -g trusted -d /nonexistent -s /bin/false -c "masqmail MTA" mail |
| 0 | 22 |
| 165 | 23 If you use other names than `mail' and `trusted' use the options |
| 24 described below for configure. The 23 and 42 are just a suggestion, | |
| 25 you can use any (not yet used) number you like, but preferably one | |
| 26 lower than 100. It does not have to be the same for the user `mail' | |
| 27 and the group `trusted'. | |
| 28 | |
| 0 | 29 |
|
174
dbe3dadd1afe
Documentation improvements in the INSTALL file and some man pages
meillo@marmaro.de
parents:
92
diff
changeset
|
30 Compiling is a matter of the usual procedure. In the source directory, |
| 59 | 31 after unpacking do: |
| 0 | 32 |
| 59 | 33 ./configure |
| 34 make | |
| 35 make install | |
| 0 | 36 |
| 37 | |
| 38 | |
| 59 | 39 Additional options for configure |
| 40 -------------------------------- | |
| 0 | 41 |
| 59 | 42 See the output of |
| 43 | |
| 44 ./configure -h | |
| 45 | |
| 165 | 46 Here is a selection of the options with additional explanations: |
| 0 | 47 |
| 165 | 48 --with-user=USER |
| 49 sets the user as which masqmail will run. Default is 'mail'. USER has | |
| 50 to exist before you 'make install'. | |
| 0 | 51 |
| 165 | 52 --with-group=GROUP |
| 53 sets the group as which masqmail will run. Default is 'trusted'. GROUP | |
| 54 has to exist before you 'make install'. | |
| 0 | 55 |
| 165 | 56 |
| 57 --with-logdir=LOGDIR | |
| 58 sets the directory where masqmail stores its log files. It will be | |
| 59 created if it does not exist. Default is /var/log/masqmail/. | |
| 0 | 60 |
| 165 | 61 --with-spooldir=SPOOLDIR |
| 62 sets the directory where masqmail stores its spool files. It will be | |
| 63 created if it does not exist. Default is /var/spool/masqmail/. | |
| 0 | 64 |
| 165 | 65 --with-confdir=CONFDIR |
| 66 sets the default configuration directory to CONFDIR, in case you | |
| 67 prefer another location than /etc/masqmail/. | |
| 68 | |
| 0 | 69 |
| 165 | 70 --enable-auth |
| 71 enables ESMTP AUTH support (disabled by default) | |
| 0 | 72 |
| 165 | 73 --enable-ident |
| 175 | 74 enables RFC 1413 support. If you have the libident dynamic library |
| 165 | 75 installed, this will be linked, otherwise it will be statically linked |
| 76 using the sources included in the package. | |
| 0 | 77 |
| 165 | 78 --disable-resolver |
| 175 | 79 disables resolver support. Without the resolver functions, masqmail |
| 165 | 80 uses only gethostbyname() to resolve DNS names, and you cannot send |
| 81 mail without a smart host. Not recommended. | |
| 0 | 82 |
| 83 | |
| 165 | 84 --with-libcryto |
| 85 instead of using the md5 and hmac functions within the package, link | |
| 192 | 86 dynamically with libcrypto. This applies only if you have SMTP AUTH |
| 87 enabled. Only makes sense if your resources are limited and you have | |
| 88 libcrypto installed. Untested. | |
| 0 | 89 |
| 90 | |
| 165 | 91 --disable-debug |
| 175 | 92 disables debugging; setting it on the command line or in the |
| 93 configuration has no effect. Strongly discouraged, since you miss | |
| 94 valuable information if something goes wrong. | |
| 0 | 95 |
| 59 | 96 |
| 97 | |
| 165 | 98 Checking the installation |
| 99 ------------------------- | |
| 0 | 100 |
| 101 Check that 'make install' worked correctly. The following command: | |
| 102 | |
|
195
5beb5d6d9623
There was still a /usr/sbin/masqmail path
meillo@marmaro.de
parents:
194
diff
changeset
|
103 ls -ld /usr/local/sbin/masqmail /etc/masqmail /var/log/masqmail/ \ |
|
174
dbe3dadd1afe
Documentation improvements in the INSTALL file and some man pages
meillo@marmaro.de
parents:
92
diff
changeset
|
104 /var/run/masqmail /var/spool/masqmail/ /var/spool/masqmail/* |
| 0 | 105 |
| 106 should give output similar to | |
| 107 | |
| 165 | 108 -rwsr-xr-x 1 root root 399356 May 10 12:34 /usr/local/sbin/masqmail |
| 59 | 109 drwxr-xr-x 2 root root 4096 May 10 12:34 /etc/masqmail |
| 110 drwxr-xr-x 2 mail trusted 4096 May 10 12:34 /var/log/masqmail | |
| 111 drwxr-xr-x 2 mail trusted 4096 May 10 12:34 /var/run/masqmail | |
| 112 drwxr-xr-x 5 mail trusted 4096 May 10 12:34 /var/spool/masqmail | |
| 113 drwxr-xr-x 2 mail trusted 4096 May 10 12:34 /var/spool/masqmail/input | |
| 114 drwxr-xr-x 2 mail trusted 4096 May 10 12:34 /var/spool/masqmail/lock | |
| 0 | 115 |
| 165 | 116 Important are the set-user-id bit for /usr/local/sbin/masqmail and |
| 117 the permissions of all files. | |
| 118 | |
| 119 | |
| 0 | 120 |
| 165 | 121 Making masqmail the default |
| 122 --------------------------- | |
| 0 | 123 |
| 165 | 124 `sendmail' is the de-facto standard name of the system's MTA, no |
| 125 matter which MTA actually runs. If you want to make masqmail the | |
| 185 | 126 system's MTA (i.e. replace sendmail, postfix, etc), make two symbolic |
| 127 links: | |
| 59 | 128 |
| 165 | 129 ln -s /usr/local/sbin/masqmail /usr/lib/sendmail |
| 185 | 130 ln -s /usr/local/sbin/masqmail /usr/sbin/sendmail |
| 0 | 131 |
| 165 | 132 Now every mailer that used to call sendmail will now call masqmail. |
| 133 If you already had an MTA installed and running, you can kill it and | |
| 134 start masqmail. Probably with: | |
| 59 | 135 |
| 165 | 136 /etc/init.d/sendmail restart |
| 59 | 137 |
| 165 | 138 If this doesn't work as expected, you might need to add a special init |
| 139 script for masqmail. Currently none is distributed with masqmail. | |
| 140 (Hopefully this will change soon.) Please ask on the mailing list for | |
| 141 help. | |
| 59 | 142 |
| 165 | 143 You can also directly start masqmail as daemon with: |
| 59 | 144 |
| 165 | 145 /usr/local/sbin/masqmail -bd -q30m |
| 59 | 146 |
| 0 | 147 |
| 148 | |
| 165 | 149 Basic Configuration |
| 150 ------------------- | |
| 59 | 151 |
| 165 | 152 The only thing you must configure in order to use masqmail is the |
| 153 hostname. It's the name under which masqmail operates. In most cases | |
| 154 it is the same as the machine's name, but it can be different. | |
| 59 | 155 |
| 227 | 156 The script `admin/guess-hostname' tries to print the hostname of |
| 165 | 157 your machine. The first output line is probably the best choice. |
| 59 | 158 |
| 165 | 159 Create a minimal config with: |
| 59 | 160 |
| 165 | 161 echo "host_name = HOSTNAME" >/etc/masqmail/masqmail.conf |
| 59 | 162 |
| 165 | 163 (Substitute `HOSTNAME' with the real value, of course.) |
| 59 | 164 |
| 165 | 165 Such a setup (i.e. the default one) does: |
| 166 - deliver mail locally | |
|
206
0241aaccfcdb
default listen_addresses: use 127.0.0.1 instead of `localhost'
meillo@marmaro.de
parents:
205
diff
changeset
|
167 - accept mail on stdin (plain text) |
|
0241aaccfcdb
default listen_addresses: use 127.0.0.1 instead of `localhost'
meillo@marmaro.de
parents:
205
diff
changeset
|
168 - accept mail on stdin (SMTP) (if started with -bs) |
|
0241aaccfcdb
default listen_addresses: use 127.0.0.1 instead of `localhost'
meillo@marmaro.de
parents:
205
diff
changeset
|
169 - accept mail on the local port 25 (SMTP) (if started with -bd) |
| 185 | 170 |
| 165 | 171 It does not |
| 185 | 172 - transfer mail to other machines |
| 165 | 173 - accept mail from outside your machine |
| 59 | 174 |
| 92 | 175 |
| 165 | 176 For more elaborate setups, have a look at docs/*setup and |
| 177 docs/INSTALL*. You can also take the example configuration files in | |
| 178 examples/ as basis for your own. Take the man pages masqmail.conf(5) | |
| 179 and masqmail.route(5) for reference. | |
| 59 | 180 |
| 165 | 181 All configuration files should go into /etc/masqmail. |
| 59 | 182 |
| 183 | |
| 184 | |
| 185 Written by oku. | |
| 165 | 186 Improved by meillo. |