vQadmin

Info: http://www.inter7.com/vqadmin-sysadmin-webcontrol/
Download (local copy): vqadmin-2.3.7
Combined patch installed (v. 2023.02.18)

vqadmin is a web based control panel that allows system administrators to perform actions which require root access — for example, adding and deleting domains.

Changelog

Feb 18, 2023
Added Ali Erturk TURKER's patch to my combo. Original patch here

Install

The patch we are going to apply is addressed to solve several issues. You can get some of these individual patches in this folder. More info are inside the patch file itself.

cd /usr/local/src
wget https://notes.sagredo.eu/files/qmail/tar/vqadmin-2.3.7.tar.gz
wget https://notes.sagredo.eu/files/qmail/patches/vqadmin/roberto_vqadmin-2.3.7.patch
tar xzf vqadmin-2.3.7.tar.gz
cd vqadmin-2.3.7
chown -R root.root .
patch -p1 < ../roberto_vqadmin-2.3.7.patch

QMAILROOT=/var/www/qmail
./configure \
        --enable-qmaildir=/var/qmail \
        --enable-cgibindir=${QMAILROOT}/cgi-bin
make
make install-strip

vQadmin will be installed in /var/www/qmail/cgi-bin/vqadmin. Eventually adjust it to your apache directory.

Setting up Apache

vQadmin will require it's own CGI-allowed, access-protected, directory to operate. Inside the virtual host you have to put

<Directory ${QMAILROOT}/cgi-bin/vqadmin>
    Require all denied 
    Options ExecCGI
    AllowOverride AuthConfig
</Directory>

And since if you install vqadmin in something else than /cgi-bin it will not work because it’s hardcoded you have to define /cgi-bin as a ScriptAlias

ScriptAlias /cgi-bin/ ${QMAILROOT}/cgi-bin/

This is my virtual host, in which I have both vQadmin and qmailadmin. I will explain the alias /image later.

Define QMAILROOT /var/www/qmail
Define LOGDIR    /var/log/apache2

<VirtualHost *:443>
#       Include /path/to/sslstuff.conf
        ServerName yourdomain.net
        DocumentRoot ${QMAILROOT}
        ScriptAlias /cgi-bin/ ${QMAILROOT}/cgi-bin/
        AddHandler cgi-script .cgi .pl
        ErrorLog  ${LOGDIR}/qmailadmin_error_log
        CustomLog ${LOGDIR}/qmailadmin_access_log common
        <Directory ${QMAILROOT}>
            AllowOverride None
            Require all granted
        </Directory>
        <Directory ${QMAILROOT}/cgi-bin>
            AllowOverride None
            Options ExecCGI
            Require all granted
        </Directory>

        # VQADMIN
        <Directory ${QMAILROOT}/cgi-bin/vqadmin>
            Require all denied
            Options ExecCGI
            AllowOverride AuthConfig
        </Directory>
        Alias /images/ ${QMAILROOT}/cgi-bin/vqadmin/images/
        <Directory ${QMAILROOT}/cgi-bin/vqadmin/images>
            Require all granted
        </Directory>
</VirtualHost>

Note that there are both qmailadmin and vqadmin on the same host

Setting up the access authorization

You can see that in the directory where vQadmin was installed there is an .htaccess file:

# cd /var/www/qmail/cgi-bin/vqadmin

# ls -la
total 148
drwxr-xr-x 4 vpopmail vchkpw   4096 2010-07-26 21:53 ./
drwxr-xr-x 3 root     apache   4096 2010-07-26 21:43 ../
-rw-r--r-- 1 nobody   apache    112 2009-08-04 17:32 .htaccess
drwxr-xr-x 2 vpopmail vchkpw   4096 2009-08-17 11:26 html/
-rw-r--r-- 1 vpopmail vchkpw    865 2009-08-17 15:03 vqadmin.acl
-rwsr-sr-x 1 root     root   122592 2010-07-26 21:53 vqadmin.cgi*

# more .htaccess
AuthType Basic
AuthUserFile /usr/local/etc/httpdpwd/vqadmin.passwd
AuthName "Authentication required"
require valid-user

/usr/local/etc/httpdpwd/vqadmin.passwd is the file where you have to store the account that is going to have access to vQadmin dir via httpd. Create an user:

# mkdir -p /usr/local/etc/httpdpw
# chown apache.apache /usr/local/etc/httpdpw
# /usr/local/apache/bin/htpasswd -bc /usr/local/etc/httpdpwd/vqadmin.passwd admin [password]

# more /usr/local/etc/httpdpwd/vqadmin.passwd
admin:xxxxxxxxxxxxxx

That's it. Open the browser and look for https://yourdomain.net/cgi-bin/vqadmin/vqadmin.cgi

The "Invalid language file" problem

The patch we applyed should have fixed this language file issue.

On some browsers you can face an "Invalid language file" error message. This is because vqadmin looks for a language folder based on the browser language setting. For example, the vqadmin's italian language file is it, but the browser's language setting is it-it. To solve this issue locate the /vqadmin/html folder and create a symbolic link as follows:

cd /var/www/qmail/cgi-bin/vqadmin/html
ln -s it it-it

queue-repair

ezmlm-browse

add a comment

Comments

Bugfixes, adds mysql-limits support to vqadmin, various UI improvements.

Ali Erturk TURKER February 18, 2023 08:36

Hi Roberto,

If you are using vpopmail with mysql backend and enabled mysql limits option (--enable-mysql-limits), vqadmin is pretty much useless, because it is not aware of this this option. It creates ".qmailadmin-limits" in the domain folder, but vpopmail does not care at all (due to --enable-mysql-limits).

- That annoyed me a little bit, so I fixed it. Now vqadmin is aware of mysql-limits, and updates the database as necessary.

- I also fixed a core-dump due to SIGILL caused by memcpy. I changed it to memmove, as suggested on this link:

The memcpy() function shall copy the first n bytes pointed to by src to the buffer pointed to by dest.
Source and destination may not overlap. If source and destination might overlap, memmove() must be used instead.

- I added missing limits and permissions, changed the UI to be more user-friendly.

The patch is here. It can be applied cleanly on your "vqadmin-2.3.7_20200226.patch".

Feel free to share it on your website.

vQadmin

Changelog

Install

Setting up Apache

Setting up the access authorization

The "Invalid language file" problem

Comments

qmail notes

LXC scripts

Other contents

Recent comments

Recent posts