the djb way



Version: qmail-1.03 (1998.06.15)
Download: qmail-1.03.tar.gz
MD5 (qmail-1.03.tar.gz) = 622f65f982e380dbe86e6574f3abcb7c
Build type: djb classic (make setup check)
errno patch: qmail-1.03.errno.patch
Other patches: qmail-1.03.qmail_local.patch

The installation procedure for qmail is the familiar, djb classic, make setup check. Despite being the largest package in Bernstein's suite, the build/install procedure is fast and straightforward.

The instructions that follow assume you have first read the pre-install section, have a /var/qmail directory already in place, and all the groups and user accounts that qmail requires have already been added.

Now, if you haven't already, obtain the source distribution for the package, as well as any of the patches you require. Right click on the links above; use ftp, wget, curl; whatever works for you. The installation procedure described below assumes the package will be available on your system in /usr/local/djb/dist/qmail-1.03.tar.gz, and patches in /usr/local/djb/patches.

Verify the MD5 checksum:

# cd /usr/local/djb/dist
# md5 qmail-1.03.tar.gz
MD5 (qmail-1.03.tar.gz) = 622f65f982e380dbe86e6574f3abcb7c

If the reported checksum doesn't agree, the package you have has been altered or corrupted. Delete the package and download it again from a trusted source.

Unpack the archive into your build directory:

# cd /usr/local/djb/build
# tar -xzvf ../dist/qmail-1.03.tar.gz

You should now find a new directory in /usr/local/djb/build named qmail-1.03. Change into this directory:

# cd qmail-1.03

Apply patches as necessary:

Note: none of these patches is strictly imperative, and only the first is necessary if compilation fails on a Linux system. If this is your first qmail installation, don't get too caught up in the issue of patches now. Later on you can read about batches o' patches and decide what's best for your own environment.

# patch -p1 < ../../patches/qmail-1.03.errno.patch
# patch -p1 < ../../patches/qmail-1.03.qmail_local.patch
# patch -p1 < ../../patches/qmail-
# patch -p1 < ../../patches/qmail-1.03.qmtpd-netstring.patch
# patch -p1 < ../../patches/

Then continue with the build/install:

# make
# make setup check

The usual splatter of compiler message will splash down your screen. When it finishes, congratulations! qmail has been compiled and installed on your system.

Sometime you can let Bernstein know how everything worked out, substituting your own name in the following:

# (echo 'Angelina Jolie'; cat `cat SYSDEPS`) | mail 

Of course, you can't really do that now, because qmail isn't actually running yet...

The next step is some configuration.

Copyright © 2002, 2003, 2004, Wayne Marshall.
All rights reserved.

Last edit 2004.10.04 wcm.