--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

CHANGES:

Updated 4/28/09: Updated qmailadmin to 1.2.12. Updated patch.

Updated 3/4/09: Due to complaints about duplicate emails, Roger Howard at http://www.g5i.net discovered a bug in the way qmailadmin creates users. This has been fixed.

Note: This page was changed as qmail-autoresponder did not work with mailing robots in qmailadmin. With the help of Chris, Robots are now working with just autorespond.

11/16/07: Added support for onchange

3/24/08: This page was moved to the development guide to the regular "Webify your qmail installation" as this doc has also been working without any issues. Please post to the forums on the left with any problems.

4/7/08: Updated onchange patch to .11

10/30/08: Updated onchange patch

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/qmailadmin/

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

# cd /usr/ports/mail/qmailadmin
# make extract
# cd work/qmailadmin-1.2.13/
# fetch http://qmail.jms1.net/vpopmail/qmailadmin-1.2.12-onchange.3.patch
# patch < qmailadmin-1.2.13-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:

Hmm...  Looks like a unified diff to me...
The text leading up to this was:
--------------------------
|diff -ruN qmailadmin-1.2.12-factory/autorespond.c qmailadmin-1.2.12-patched/autorespond.c
|--- qmailadmin-1.2.12-factory/autorespond.c    2007-09-21 19:27:38.000000000 -0400
|+++ qmailadmin-1.2.12-patched/autorespond.c    2008-12-21 15:55:12.000000000 -0500
--------------------------
Patching file autorespond.c using Plan A...
Hunk #1 succeeded at 186.
Hmm...  The next patch looks like a unified diff to me...
The text leading up to this was:
--------------------------
|diff -ruN qmailadmin-1.2.12-factory/command.c qmailadmin-1.2.12-patched/command.c
|--- qmailadmin-1.2.12-factory/command.c        2007-01-01 18:17:06.000000000 -0500
|+++ qmailadmin-1.2.12-patched/command.c        2008-12-21 15:26:17.000000000 -0500
--------------------------
Patching file command.c using Plan A...
Hunk #1 succeeded at 308 (offset 2 lines).
Hmm...  The next patch looks like a unified diff to me...
The text leading up to this was:
--------------------------
|diff -ruN qmailadmin-1.2.12-factory/user.c qmailadmin-1.2.12-patched/user.c
|--- qmailadmin-1.2.12-factory/user.c   2007-11-03 13:44:12.000000000 -0400
|+++ qmailadmin-1.2.12-patched/user.c   2008-12-21 15:27:57.000000000 -0500
--------------------------
Patching file user.c using Plan A...
Hunk #1 succeeded at 626 (offset 15 lines).
done

We now want to cd to the port and then 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!!!

# cd /usr/ports/mail/qmailadmin
# make CONFIGURE_ARGS="--enable-modify-spam=Y
--enable-spam-command='|preline -f /usr/local/bin/maildrop mailfilter'
--enable-cgibindir=/path/to/cgi-bin --enable-htmldir=/path/to/www
--enable-imagedir=/path/to/www/images --enable-help
--enable-autoresponder-path=/usr/bin  --enable-modify-quota"

Run the following to install qmailadmin:

# make install

If that compiles with no errors, qmailadmin is installed.

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

Now we want to clean up the install:

# cd /usr/ports/mail/qmailadmin
# make clean

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