A step by step guide on how to install vQadmin on FreeBSD
vQadmin is a web interface for administrating Qmail. You’ll need vQadmin for functions that Qmailadmin is missing like creating or deleting domains editing control files and so on. Qmailadmin can do stuff that vQadmin can’t. So if you don’t want to use command line options to administrate Qmail you will need to have both installed. Qmailadmin and vQadmin that is.
We will install vQadmin from ports. This whole thing should not take more than a couple of minutes to install.
Now vQadmin needs to know a 2 things within the configuration arguments. You should change
“usr/local/www/cgi-bin” to where your cgi-bin resides
“usr/local/www” to where your www directory resides
cd /usr/ports/mail/vqadmin
make CONFIGURE_ARGS="--enable-cgibindir=/usr/local/www/cgi-bin --enable-htmldir=/usr/local/www"
make install clean
Next we need to setup vQadmin’s .htaccess file This is used to grant access to the vQadmin site. Change “usr/local/www/cgi-bin” to where vQadmin is installed.
cd /usr/local/www/cgi-bin/vqadmin
vi .htaccess
Change “path to password file” to where you want to keep your .htpasswd file.
AuthType Basic
AuthUserFile /path to the .htpasswd file/.htpasswd
AuthName vQadmin
require valid-user
satisfy any
Set the permissions on the .htaccess file to whatever process your webserver in running as. I.e. www, or apache may even be nobody. Depending on your system setup.
chown www .htaccess
Next We need to set the password associated with the .htaccess file we just created. Replace newpassword with the password you would like. Note The next line is one long line.
htpasswd -bc /path to the .htpasswd file/.htpasswd admin newpassword
Set the permissions on the .htpasswd file to whatever process your webserver in running as. I.e. www, or apache may even be nobody. Depending on your system setup.
chmod 644 /path to the htpasswd file/.htpasswd
We need to be able to access vQadmin through web therefor we need to modify the apache configuration file slightly. Add the following to your apaches configuration file. You should change the “/usr/local/www/cgi-bin” to where your cgi-bin resides.
<Directory "/usr/local/www/cgi-bin/vqadmin">
deny from all
Options ExecCGI
AllowOverride AuthConfig
Order deny,allow
</Directory>
And restart apache.
apachectl restart
Now you should be able to access vQadmin by typing the following url in a browser of your choice either
http://www.yourdomain.xxx/cgi-bin/vqadmin/vqadmin.cgi or IP-Number/cgi-bin/vqadmin/vqadmin.cgi
Guide On How To Install Qmail On FreeBSD Guide On How To Install Qmailadmin On FreeBSD