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.

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

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

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.

• cgibindir=/your/path/to/cgi-bin
• htmldir=/your/path/to/webdir
• imagedir=/your/patch/to/qmailimages

Optional changes Start

• maxusersperpage=50 (The number of accounts shown before you need to hit next)
• maxaliasesperpage=50 (The number of alias's shown before you need to hit next)

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

Run the following commands to install Qmailadmin.

make
make install-strip

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>

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

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