masqmail

annotate INSTALL @ 378:5781ba87df95

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