QmailAdmin is a cgi program for administering Qmail with vchkpw. It provides a web interface to create users, aliases, install ezmlm lists and also configure mailing robots. For more information, Please see http://www.inter7.com

We need to enable the cgi setting in the httpd.conf file to allow sgi scripts to run:


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

Uncomment this line:


LoadModule cgi_module libexec/apache24/mod_cgi.so

Now restart apache:


# /usr/local/etc/rc.d/apache24 restart

We will want to extract qmailadmin and apply John Simpsons onchange patch. Since qmailadmin doesn't support onchange out of the box, We need to add support for it:


# cd ~root
# tar zxvf ~root/qmail/qmailadmin-1.2.16.tar.gz
# cd qmailadmin-1.2.16
# patch < ~root/qmail/qmailadmin-1.2.12-onchange.3.patch

Don't be too concerned about the version conflicts. The patch applies cleanly without errors. You should get a fairly short output.

We now want run the configure command for qmailadmin. Please change the sections cgibindir, htmldir and imagedir to the cgi, html and image paths on your system.

Please type the make CONFIGURE_ARGS line in as ONE COMPLETE LINE!!!


./configure --enable-modify-spam=Y --enable-spam-command='|preline -f /usr/local/bin/maildrop mailfilter' --enable-htmldir=/usr/local/www/apache24/data --enable-cgibindir=/usr/local/www/apache24/cgi-bin --enable-imagedir=/usr/local/www/apache24/data/images --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

Run the following to install qmailadmin:


# make
# make install-strip

If that compiles with no errors, qmailadmin is installed.

Copying image files

We need to copy the image files so they appear on the qmailadmin page:


# mkdir /usr/local/www/apache24/data/images /usr/local/www/apache24/data/images/qmailadmin/ (You may or may not need to run this command)
# cp -Rp /root/qmailadmin-1.2.16/images/* /usr/local/www/apache24/data/images/qmailadmin/

Configuring qmailadmin

When we add new users via qmailadmin, we want Spam Fighting turned on by default. Edit the following:


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

and then do a search for

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

and change it to

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

This allows the "Spam Detection" box in the users email-account to automatically be checked when each user in qmailadmin is created.

That is it for configuring qmailadmin! If you go to http://www.domain.xxx/cgi-bin/qmailadmin you should see the logon screen. You can create some mailboxes for your domain if you like. If you need to add a domain, I would use the command line tool at ~vpopmail/bin/vadddomain