qmailAdmin is a free software package that provides a web interface for managing a qmail system with virtual domains. Works with vpopmail. It provides admin for adding/deleting users, Aliases, Forwards, Mailing lists and Auto-Responders.

According to the help file provided with the tarball: Before we can make and install, there are a few things to consider.

  1. Do you have a vpopmail user and vchkpw group?

  2. Where is your cgi bin directory?

  3. Where is your ezmlm directory? default /usr/local/bin/ezmlm

  4. Where is your autorespond directory? /usr/local/bin [AutoRespond needs to be version 2.0 or greater)

We should have the answers to these questions before proceeding.

  1. We have vpopmail user (uid=708) and vchkpw group(gid=702)

  2. My cgi-bin directory is /var/www/cgi-bin

  3. EZMLM directory is /usr/local/bin/ezmlm/

  4. We have installed autorespond 2.04 . By default it gets installed in /usr/bin .

QMR provides qmailadmin-1.2.9.tar.gz . The latest stable on Inter 7 is 1.2.12. The latest devel version is 1.2.13 .

cd /downloads/qmailnew/
wget http://internap.dl.sourceforge.net/sourceforge/qmailadmin/qmailadmin-1.2.13.tar.gz
tar xzf qmailadmin-1.2.13.tar.gz
cd /downloads/qmailnew/qmailadmin-1.2.13

–Optional Start–

mkdir /var/www/qmailadmin

cat > /etc/httpd/conf.d/qmailadmin.conf << EOF

Alias /qmailadmin /var/www/qmailadmin  

<Directory /var/www/qmailadmin>

Order deny,allow

Allow from all



chown apache:apache /var/www/qmailadmin -R

service httpd restart

–Optional End–

Configure qmailadmin:

./configure –enable-cgibindir=/var/www/cgi-bin –enable-htmldir=/var/www/qmailadmin
--enable-imagedir=/var/www/qmailadmin/images –enable-imageurl=/qmailadmin/images


[root@www qmailadmin-1.2.13]# make && make install-strip


chmod 644 /usr/local/share/qmailadmin/lang/*

/bin/sh ./mkinstalldirs /var/www/qmailadmin/images

mkdir /var/www/qmailadmin/images

cp ./images/*.png /var/www/qmailadmin/images

make[2]: Leaving directory `/downloads/qmailnew/


make[1]: Leaving directory `/downloads/qmailnew/

[root@www qmailadmin-1.2.13]#

Now,Try log on to the URL:

http://www.example.com/cgi-bin/qmailadmin and try add a few users. I tried creating my email account and it worked! Email Account kamran@example.com (Muhammad Kamran Azeem) added successfully.

Errors / Trouble-shooting:

Blank page after adding a user.

[Tue Apr 01 05:00:42 2008] [error] [client] vmysql: can’t read settings from /home/vpopmail/etc/vpopmail.mysql, referer: [Tue Apr 01 05:00:42 2008] [error] [client] Premature end of script headers: qmailadmin, referer:

There can be many reasons for a blank page, mostly related to permission and ownership problems. During my setup, I incorrectly setup the permission of the directory ~vpopmail/etc as 640. This mistake, resulted in inability of group vchpw to change directory into ~vpopmail/etc and read the vpopmail.mysql file.

Email Account kamran@example.com (Muhammad Kamran Azeem) added successfully Alhumdulillah. The qmailadmin web interface seems to be behaving correctly.