We Bring In Tomorrows Technology

  • Full Screen
  • Wide Screen
  • Narrow Screen
  • Increase font size
  • Default font size
  • Decrease font size

QmailAdmin for Qmail ...

E-mail Print PDF
User Rating: / 8

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

make[1]: Leaving directory `/downloads/qmailnew/qmailadmin-1.2.13'

[root@www qmailadmin-1.2.13]#



Now,Try log on to the URL:




, and try add a few users. I tried creating my email account and it worked!


Email Account This e-mail address is being protected from spambots. You need JavaScript enabled to view it (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 This e-mail address is being protected from spambots. You need JavaScript enabled to view it (Muhammad Kamran Azeem) added successfully


Alhumdulillah. The qmailadmin web interface seems to be behaving correctly.


You are here How To / Tutorials QmailAdmin for Qmail ...