meillo@0: simple installation instructions, see docs/install.html for more. meillo@0: meillo@0: To compile MasqMail you need glib 1.2 (http://www.gtk.org). meillo@0: meillo@0: You need a user and a group for masqmail to run, I suggest user meillo@0: 'mail' and group 'trusted'. Say: meillo@0: meillo@0: groupadd -g 42 trusted meillo@0: useradd -u 42 -g 42 -d / -s /bin/sh -c "Mail Transfer Agent" mail meillo@0: meillo@0: If you use other names than 'mail' and 'trusted' use the options meillo@0: described below for configure. The 42 is just a suggestion, you can meillo@0: use any number you like, but preferably one < 100. It does not have meillo@0: to be the same for the user 'mail' and the group 'trusted'. meillo@0: meillo@0: Then do: meillo@0: meillo@0: ./configure meillo@0: make meillo@0: make install meillo@0: meillo@0: Debian: meillo@0: If you compile for Debian, do the configure with at least these options, meillo@0: this makes it compatible with the official debian package: meillo@0: ./configure --with-liblockfile --with-group=mail meillo@0: you do not need the group 'trusted', use 'mail' instead. meillo@0: meillo@0: You can also build your own Debian package with meillo@0: dpkg-buildpackage -rfakeroot meillo@0: You need to have fakeroot installed to do this. Or, as root, do: meillo@0: dpkg-buildpackage meillo@0: meillo@0: SuSE/Redhat: meillo@0: There are spec files for rpm creation in suse/ or redhat/. You may have to adjust these files. meillo@0: meillo@0: meillo@0: Sorry, but after that you are not yet finished. For instruction on how meillo@0: to deliver mail using a connection to your ISP see meillo@0: docs/install.html. It is probably a good idea to copy the files meillo@0: docs/*.html to a directory where you can access them with a browser. meillo@0: meillo@0: additional options for configure: meillo@0: --------------------------------- meillo@0: meillo@0: --with-user=USER sets the user as which MasqMail will run. Default is meillo@0: 'mail'. USER has to exist before you 'make install'. meillo@0: meillo@0: --with-group=GROUP sets the group as which MasqMail will run. Default meillo@0: is 'trusted'. GROUP has to exist before you 'make install'. meillo@0: meillo@0: --with-logdir=LOGDIR sets the directory where MasqMail stores its log meillo@0: files. It will be created if it does not exist. Default is /var/masqmail/. meillo@0: meillo@0: --with-spooldir=SPOOLDIR sets the directory where MasqMail stores its meillo@0: spool files. It will be created if it does not exist. Default is meillo@0: /var/spool/masqmail/. meillo@0: meillo@0: --with-confdir=CONFDIR sets the default configuration directory to meillo@0: CONFDIR, in case you prefer another location than /etc/masqmail/. meillo@0: meillo@0: --enable-auth enables ESMTP AUTH support (disabled by default) meillo@0: meillo@0: --disable-pop3 disables pop3 support (enabled by default) meillo@0: meillo@0: --enable-maildir enables qmail style Maildir support (disabled by default) meillo@0: meillo@0: --enable-ident enable RFC 1413 support. If you have the libident meillo@0: dynamic library installed, this will be linked, otherwise it will be meillo@0: statically linked using the sources included in the package. meillo@0: meillo@0: --disable-resolver disable resolver support. Without the resolver functions, meillo@0: masqmail uses only gethostbyname() to resolve DNS names, and you cannot send meillo@0: mail without a smart host. Not recommended. You save 3K at most. meillo@0: meillo@0: --disable-smtp-server disable SMTP server support. You may want this if you do meillo@0: not need masqmail to listen. In this case, you cannot use masqmail as a smart meillo@0: host for other hosts on your LAN, you cannot use mail clients that send SMTP, meillo@0: you cannot even use pine. In short, use of this option is discouraged unless meillo@0: your resources are extremely limited. meillo@0: meillo@0: --enable-mserver enable online detection by connecting to the mserver meillo@0: (masqdialer system). meillo@0: meillo@0: --with-libcryto instead of using the md5 and hmac functions within the package, meillo@0: link dynamically with libcrypto. This applies only if you have pop3 or SMTP meillo@0: AUTH enabled. Makes only sense if your resources are limited and you have meillo@0: libcrypto installed. Untested. meillo@0: meillo@0: --with-glib-static link with glib statically. This makes the binary larger meillo@0: by around 30K (i386 architecture), but if masqmail is the only binary using meillo@0: glib, you save some space in total, because you do not need the shared glib meillo@0: library installed. meillo@0: meillo@0: --disable-debug disable debugging, setting it on by command line or configuration meillo@0: has no effect. Strongly discouraged, since you miss valuable information if something meillo@0: goes wrong. You save 6K. meillo@0: meillo@0: BTW, to get 3K of space, call meillo@0: strip --remove-section=.comment --remove-section=.note --strip-unneeded src/masqmail meillo@0: meillo@0: after make install: meillo@0: ------------------- meillo@0: meillo@0: You can also use these instructions to omit 'make install' if you do meillo@0: not want to use it. meillo@0: meillo@0: Check that 'make install' worked correctly. The following command: meillo@0: meillo@0: ls -ld /usr/sbin/masqmail /var/masqmail/ /var/spool/masqmail /var/spool/masqmail/input meillo@0: meillo@0: should give output similar to meillo@0: meillo@0: -rwsr-xr-x 1 root root 86955 Oct 14 14:27 /usr/sbin/masqmail meillo@0: drwxr-xr-x 2 mail trusted 1024 Oct 14 14:29 /var/masqmail/ meillo@0: drwxr-xr-x 3 mail trusted 1024 Oct 14 14:27 /var/spool/masqmail meillo@0: drwxr-xr-x 2 mail trusted 1024 Oct 14 18:32 /var/spool/masqmail/input meillo@0: drwxr-xr-x 2 mail trusted 1024 Oct 14 18:32 /var/spool/masqmail/lock meillo@0: drwxr-xr-x 2 mail trusted 1024 Oct 14 18:32 /var/spool/masqmail/popuidl meillo@0: meillo@0: (important is the set-user-id bit for /usr/sbin/masqmail and the meillo@0: ownership of all items). meillo@0: meillo@0: Use the example configuration files in examples/ to edit your own. The meillo@0: main configuration should go to /etc/masqmail.conf. I recommend to meillo@0: make a directory /etc/masqmail for the *.route amd *.get files. meillo@0: meillo@0: The default destination for the executable 'masqmail' is meillo@0: /usr/sbin. Check that it has the set user id bit set. (chmod u+s meillo@0: /usr/sbin/masqmail does no harm in any case). meillo@0: meillo@0: If you want to replace sendmail, move your old sendmail binary to meillo@0: another name and make a symbolic link /usr/sbin/sendmail -> meillo@0: /usr/sbin/masqmail. meillo@0: meillo@0: