oMail-admin

A PHP based qmail+vmailmgrd Web interface

Copyright (c) 2004 Olivier Mueller om@omnis.ch Copyright (C) 2026 LoneStar lonestar@lonestar.it

Project maintenance has been taken over by LoneStar lonestar@lonestar.it

Overview

oMail-admin is a web-based administration interface for managing qmail mail servers with vmailmgrd. It provides a user-friendly way to manage mail accounts, domains, aliases, and other mail server settings through a web browser.

Features

• Web-based interface for managing qmail+vmailmgrd mail servers
• Create, edit, and delete mail accounts
• Manage email aliases and forwarders
• Domain administration
• Support for multiple languages (with translations available)
• Mailbox quota management
• LDAP support (experimental)
• Anti-spam configuration support

Requirements

To run oMail-admin, you will need:

• qmail 1.03 (Dan Bernstein) - http://www.qmail.org
• vmailmgrd 0.96.8 or higher (Bruce Guenter) - http://www.em.ca/~bruceg/vmailmgr/
• uscpi-unix 0.34 or higher OR ucspi-tcp (Bruce Guenter/Dan Bernstein) - needed for the daemon to work
• qmail-autoresponder 0.93 or higher (Bruce Guenter) - http://www.em.ca/~bruceg/qmail-autoresponder/
• PHP 8.4 or higher
• Apache 1.3.x or compatible web server

Installation

1. Install qmail, autoresponder, and vmailmgr
2. Make sure that vmailmgrd (the vmailmgr daemon) is running. Don't forget it needs uscpi-unix or uscpi-tcp to work. Check INSTALL.daemon for some real-life examples of working setups.
3. Extract oMail-admin to your web server's document root
4. Check config.php and set up the configuration variables to match your system
5. If "index.php" is not defined as DirectoryIndex in your Apache conf, replace the $script_url = "$SCRIPT_URL"; line in config.php by $script_url = "$SCRIPT_URL/index.php";
6. Make sure you have installed the autoresponder correctly (look at the vautoresponder file in the qmail-autoresponder distribution...)
7. Set up domain-based quotas if necessary (see quota configuration section)
8. If you want to display mailbox usage (size of accounts), etc., you can setup the scripts/vmailstats.pl script. Check the readme file in the scripts/ directory.

Configuration

You need to configure the settings in config.php to match your mail server setup:

• Set connection details for vmailmgrd
• Configure language preferences
• Set up directory paths
• Configure quota settings

Quotas

Check the vmailmgrquota file, and copy it in /var/qmail/control or /etc/vmailmgr. You can use the quota's configuration file to disallow the use of autoresponders: just activate the "default" configuration, and set "0" in the last field...

Languages

oMail-admin supports multiple languages including:

• English
• French
• German
• Danish
• Czech
• Japanese
• Chinese (Traditional)
• Spanish
• Polish
• Brazilian Portuguese
• Dutch
• Italian
• Romanian
• Russian
• Swedish
• Lithuanian
• Indonesian

To add or modify language translations, edit the strings.php file.

LDAP Support

oMail-admin includes experimental LDAP support that allows you to enter first and last names, which creates user info entries in LDAP. The organization unit is the domain name minus the top-level domain. For details on LDAP configuration, see the README.LDAP file.

Anti-Spam Support

The system supports integration with SpamAssassin in SQL mode for enhanced anti-spam capabilities. For more details, see the README.antispam file.

Git Repository

The source code is available at:

git clone https://git.hirad.it/lonestar/omail-admin.git

Support and Community

To discuss or get support about this program, please subscribe to the mailing list. Please do not send private mail, or you will probably only get the standard "please ask on the ML" answer.

Mailing Lists:

• Development: http://lists.sourceforge.net/mailman/listinfo/omail-admin-devel/
• News: http://lists.sourceforge.net/mailman/listinfo/omail-admin-news/
• Archives: http://sourceforge.net/mailarchive/forum.php?forum=omail-admin-devel

Contributing

The project is open source and available under the GNU General Public License. If you need specific features to match your needs (such as using omail-admin on ISP servers or integrating it into an existing interface), you can request commercial support.

Credits

This project has been developed with contributions from:

• Bruce Guenter - creator of the vmailmgr system
• Mike Bell - maintainer of the PHP interface for vmailmgr
• Joel Alan Chornik - translation to Spanish
• Nervous - translation to Italian
• Martin Bachmann & Ueli Leutwyler - templates subroutines
• Andy Krasilnikov - translation to Russian
• Tobias Oetiker - For the CD-Ware idea
• Keld Graugaard - translation to Danish
• Harald Nikolaus - coordinated translation to Romanian and improved German translation
• Bogdan Taru - translation to Romanian
• Rey IJben - translation to Dutch, LDAP support
• Hideto Sakaguchi - bugfixes and translation to Japanese
• Ming - translation to Chinese
• Thomas Højemo - translation to Swedish
• Peter Green - patch for mailboxes selection by letter
• Lumir Srch - translation to Czech
• Jim Walker - suggestions and help file
• Suryanto Rachmat - translation to Indonesian
• Zeus - translation to Brazilian Portuguese
• Tomas Kuliavas - translation to Lithuanian
• Piotrek - translation to Polish
• And many others who contributed patches, bug reports, and feedback

License

oMail-admin is available under the GNU General Public License (GPL). See the COPYING file for more information.

FAQ

Q: Error Message: Protocol version is 0, not the 2 as this script expects. A: This seems to be a common daemon problem, and appears only with rpm installations. In your /etc/rc.d/init.d/vmailmgrd file change the line that reads: svc start vmailmgrd to something like: nohup /var/service/vmailmgrd/run & and things run fine. Note that the stop function stops working in this case.

Status

Work in progress - please report any bugs! Thanks!

For translators: please look at the TRANSLATION file.

-- Olivier Mueller om@omnis.ch -- LoneStar lonestar@lonestar.it