Guide updated on 29th of February 2016

Install Vqadmin

Vqadmin is simply a nice web based interface that will let us manage Vpopmail. Through the interface we can create new domains, new users, net quotas, enable services and much more.

mkdir -p /var/www/mail/cgi-bin
cd /downloads/
tar zxvf vqadmin-2.3.7.tar.gz
cd /downloads/vqadmin-2.3.7

patch < /downloads/patches/vqadmin-2.3.7_lang.patch
cp /downloads/vqadmin-2.3.7/config.sub /downloads/vqadmin-2.3.7/config.sub.bak
cp /downloads/vpopmail-5.4.33/config.sub /downloads/vqadmin-2.3.7

You can find HERE all compilation options.

./configure --enable-cgibindir=/var/www/mail/cgi-bin --enable-isoqlog=y

make && make install-strip

mv /var/www/html/images /var/www/mail/
cp /var/www/mail/cgi-bin/vqadmin/html/en-us /var/www/mail/cgi-bin/vqadmin/html/en-US
chown vpopmail:vchkpw /var/www/mail/cgi-bin/vqadmin/html/en-US
mv /var/www/mail/cgi-bin/vqadmin/.htaccess /var/www/mail/cgi-bin/vqadmin/htaccess.bak

Create the password file to access this interface

htpasswd -bc /var/www/mail/cgi-bin/vqadmin/.htpasswd admin YOUR_WEB_PASSWORD
chown vpopmail:vchkpw /var/www/mail/cgi-bin/vqadmin/.htpasswd

We 'll test this web interface later ...

Install Qmailadmin

Users comments
Matthew - 04/10/2015 23:48

Hi there - looking for some input on this if any one has any?


/downloads/vqadmin-2.3.7# ./configure --enable-cgibindir=/var/www/mail/cgi-bin -enable-htmldir=/var/www/mail/ --enable-isoqlog=y

The following is reported.

configure: WARNING: unrecognized options: --enable-htmldir

Any help appreciated.

Jurgen - 26/03/2013 22:10

if you receive the error:

vqadmin unable to chdir to vpopmail/domains/domain directory

when attempting to add domains etc, it is a permissions issue but not the permissions issue you will find on google. They all tell you to change permissions in /home/vpopmail.

I found the permissions issue was for the vqadmin and qmailadmin binaries in


. In my infinite wisdom I ran a

chown -R www-data:www-data /varwww/mail

and this is INCORRECT!

So I ran the installs again and found the true permissions for these folders:

/var/www/mail/cgi-bin # ls -als
200 -rwsr-sr-x 1 vpopmail vchkpw   201456 Mar 26 21:14 qmailadmin
  4 drwxr-xr-x 3 vpopmail vchkpw     4096 Mar 26 21:07 vqadmin


Thibs - 09/11/2012 10:23

Hello Carlo,

I had the same problem on a really old install several years ago ... and I've never found a solution ;-(

My alternative was to restart qmail twice a day by cron ;-(

Carlo - 07/11/2012 20:08

I have this problem:

when I add a domain, I must restart qmail manually, otherwise the new domain is not recognized by the system, and emails sent to any user @ that domain is bounced back with the error ' Sorry. Although I'm listed as a best-preference MX or A for that host...'

does anybody know how to fix that?


Carlo - 01/10/2012 17:23

nice guide, thanks. qmailrocks was ways too old, qmail remains a real pain, especially when building every single package manually, new distro version not compatible with libraries, etc.

btw, i made it work on slackware 13 64bit, and I've just realized that I must restart qmail ( qmailctl restart ) after I add a new domain, otherwise qmail does not recognize the new user

vuserinfo user@domain works
Saza - 19/01/2012 05:49
libtoolize --force
Thibs - 26/09/2011 12:46


Take a look just above this message ... you have to put admin/YOUR_WEB_PASSWORD as credentials

For your permission problem be sure to have followed instructions on webtools.php

Rashed mhabub - 24/09/2011 12:36

Thanks for your reply. Now installation is ok. But new problem is :

when i logged into the ".../vqadmin/vqadmin.cgi " it wants userid and password. I give userid 'admin' and password "which is sat at mysql for vqadmin'. It's logged in and show "Internal server error: 500".  

I see the '/var/log/apache2/"   and found

Permission denied [13] : exec of ....
Premature end of scripts headers : vqadmin.cgi

what should I do now..?

Thibs - 22/09/2011 12:13

Hello Rashed,

I think I have found by reading

Did you run the command

cp /downloads/vpopmail-5.4.33/config.sub /downloads/vqadmin-2.3.7


If it's still do not work, take a look to

Rashed mhabub - 22/09/2011 11:09

When i execute ./configure ..... command,  it shows

/downloads/vqadmin-2.3.7/missing : Unknown --run option.
Warning : missing file is too old or missing

I can go to the login page of vqadmin and after giving userid and password  i set here, it shows 'Internal Server problem"

Could u please tell me what should i do now..?

Color Coded Qmail Installation Key
  Regular Black Text     Qmail installation notes and summaries by the author.
  Bold Black Text     Commands to be run by you, the installer.
  Bold/Regular Red Text    Vital and/or critical information.
  Regular Blue text     Denotes helpful tips and hints or hyperlinks.
  Regular Orange Text     Command line output.
  Bold/Regular green text     Denotes the contents of a file or script.