Table of Contents

How To Install Qmailadmin On FreeBSD

Qmailadmin is a web interface for administrating Qmail. You could live without Qmailadmin and use command line options instead and it would work flawlessly. But if you are not familiar with how that works Qmailadmin can make your life easier.

Preflight checklist

Qmailadmin relies on cgi so make sure mod_cgi.so is enabled in httd.conf

vi /usr/local/etc/apache24/httpd.conf

Find the following lines. (This may differ a bit from httpd.conf to httpd.conf) but you get the idea.

<IfModule mpm_prefork_module>
# LoadModule cgi_module libexec/apache24/mod_cgi.so
</IfModule>

Change them so they look like this.

# <IfModule mpm_prefork_module>
LoadModule cgi_module libexec/apache24/mod_cgi.so
# </IfModule>

Check Apache for errors and restart

apachectl configtest
apachectl restart

Download and patching Qmailadmin

The patch we are applying here is John Simpsons onchange patch.

cd ~root
fetch http://www.xfiles.dk/content/files/freebsd-qmail/qmailadmin-1.2.16.tar.gz
tar zxvf qmailadmin-1.2.16.tar.gz
rm qmailadmin-1.2.16.tar.gz
cd qmailadmin-1.2.16
fetch http://www.xfiles.dk/content/files/freebsd-qmail/qmailadmin-1.2.16-onchange.3.patch
patch < qmailadmin-1.2.16-onchange.3.patch

Configure Qmailadmin

Oh you gonna love this one. Please run the command below as “One Single Line” I can’t emphasize this enough.

Before you run it however please adjust the following statements to represent the paths on your system.

Optional changes Start

Optional changes Stop

Right a last reminder this is “One Single Line”

./configure --enable-modify-spam=Y --enable-spam-command='|preline -f /usr/local/bin/maildrop mailfilter' --enable-htmldir=/usr/local/www --enable-cgibindir=/usr/local/www/cgi-bin --enable-imagedir=/usr/local/www/qmailimages --enable-qmaildir=/var/qmail --enable-vpopuser=vpopmail --enable-vpopgroup=vchkpw --enable-autoresponder-path=/usr/local/bin --enable-ezmlmdir=/usr/local/bin/ezmlm --enable-modify-quota --disable-ezmlm-mysql --enable-maxusersperpage=50 --enable-maxaliasesperpage=50

Note For a full list of options you can use this command.

./configure --help=short

Installing Qmailadmin

Run the following commands to install Qmailadmin.

make
make install-strip

Enable Spamcheck

We can enable spamcheck so that it is selected by default when creating a mailbox. It's done like this.

vi /usr/local/share/qmailadmin/html/add_user.html

Find the following line.

<input type="checkbox" name="spamcheck">

And replace it with this one.

 <input type="checkbox" name="spamcheck" checked>

Fix Broken Images

If for some reason your Qmailadmin images appear as broken links you may fix this by adding an alias to your httpd.conf file, the syntax is as follows.

Alias /images/qmailadmin "/real/path/to/qmail images/"

As for the logo on the front page that is missing you can grab it here.

cd /real/path/to/qmail images/
fetch http://www.xfiles.dk/content/files/freebsd-qmail/middleleft1.png

Accessing Qmailadmin

in order to access Qmailadmin fire up a browser and type either.

http://www.yourdomain.xyz/cgi-bin/qmailadmin or http://your-ip/cgi-bin/qmailadmin