This page describes how to install hMailServer WebAdmin, the PHP administration front-end for hMailServer.
While hMailServer may work with older versions of PHP, it has not been tested.
The current code is incompatible with PHP versions starting with 8.0.0 due to function deprecation.
A clean installation of PHP has many features and extensions disabled. Some of these needs to be enabled to be able to use PHPWebAdmin. If you have just installed PHP, you need to copy php.ini-production to php.ini and make the following adjustments.
PHP accesses hMailServer API using COM. COM support is not enabled by default in PHP.
To enable it, locate the Dynamic Extensions section in php.ini, and add the following line:
extension=php_com_dotnet.dll
In PHP.ini, change the setting session.save_path to a folder where you want PHP to store session files. For example:
session.save_path = "C:\PHP\sessions"
Note: The directory must exist, and be writeable by the web server process..
PHP needs to have access to the hMailServer COM API. To do this, you need to configure DCOM permissions.
Copy PHPWebAdmin from the hMailServer directory to your web root directory. The web root differs between web servers so check your web server's documentation if you're unsure where your web root is located. Copy the entire PHPWebAdmin from C:\Program Files\hMailServer to your web root. Example: If your web root is C:/wwwroot, copy PHPWebAdmin to C:\wwwroot, so that you get C:\wwwroot\PHPWebAdmin.
Alternately, you can use the PHPWebAdmin folder where hMailServer installed, you will neede to point your webserver to that folder and set permissions as above.
Go to the PHPWebAdmin directory in the web root.
Point your web browser to http://localhost/PHPWebAdmin and log in with your hMailServer username and password.
When you upgrade your hMailServer installation to a later version, make sure to copy the latest WebAdmin from the hMailServer installation directory to your web directory. If you do not do this, you will get an error message when trying to access WebAdmin.
There's a few common set up mistakes. Read more in the troubleshooting guide.