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.
Do you have a vpopmail user and vchkpw group?
Where is your cgi bin directory?
Where is your ezmlm directory? default /usr/local/bin/ezmlm
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.
We have vpopmail user (uid=708) and vchkpw group(gid=702)
My cgi-bin directory is /var/www/cgi-bin
EZMLM directory is /usr/local/bin/ezmlm/
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
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 </Directory> EOF chown apache:apache /var/www/qmailadmin -R service httpd restart
./configure –enable-cgibindir=/var/www/cgi-bin –enable-htmldir=/var/www/qmailadmin
[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: Leaving directory `/downloads/qmailnew/ qmailadmin-1.2.13' make: Leaving directory `/downloads/qmailnew/ qmailadmin-1.2.13' [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 firstname.lastname@example.org (Muhammad Kamran Azeem) added successfully.
Errors / Trouble-shooting:
Blank page after adding a user.
[Tue Apr 01 05:00:42 2008] [error] [client 184.108.40.206] vmysql: can’t read settings from /home/vpopmail/etc/vpopmail.mysql, referer: http://220.127.116.11/cgi-bin/qmailadmin [Tue Apr 01 05:00:42 2008] [error] [client 18.104.22.168] Premature end of script headers: qmailadmin, referer: http://22.214.171.124/cgi-bin/qmailadmin
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 email@example.com (Muhammad Kamran Azeem) added successfully Alhumdulillah. The qmailadmin web interface seems to be behaving correctly.