Installing PHPWebAdmin

This page describes how to install PHPWebAdmin, the PHP administration front-end for hMailServer.


  • Apache or IIS (or any other PHP compatible web server)
  • PHP >= 4.3.11 or PHP >= 5.0.3. Due to bugs in PHP 4.3.10, hMailServer does not work with that version.
  • The PHP setting register_globals must be set to off for PHPWebAdmin to work properly.
  • In the PHP configuration, the following settings must be configured for PHPWebAdmin to work properly:
    • register_globals must be set to off
    • display_errors must be set to off

Step 1: Copy the files

The first step is to 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.

The description below assumes your web root is C:/wwwroot.

Step 2: Setup

Go to the PHPWebAdmin directory in the web root.

  1. Rename the file config-dist.php to config.php
  2. The file config.php contains the basic settings for PHPWebAdmin and needs to be modified to correctly adjust it for your system:

    • Set the value of rootpath to your root web directory where PHPWebAdmin is placed.
      $hmail_config['rootpath'] = "C:/wwwroot/PHPWebAdmin/";
    • Set the value of rooturl to the URL where the PHPWebAdmin will be located.
      $hmail_config['rooturl'] = "http://localhost/PHPWebAdmin/";

  3. Open up php.ini, and make sure that short_open_tag is set to On (No longer necessary in hMailServer 4.4 or above!)
  4. If you're using IIS6 or run your web server (Apache or IIS) as a specific user account with limited permissions, you need to follow these steps.

Step 3: Use it

Point your web browser to http://localhost/PHPWebAdmin and log in with the username and password you specified in config.php. If you are using hMailServer 4 or later, you should log in using your hMailServer account.

When you upgrade your hMailServer installation to a later version, make sure to copy the latest PHPWebAdmin from the hMailServer installation directory to your web directory. Not doing this may prevent PHPWebAdmin from working.

Common configuration errors

There's a few common set up mistakes. Read more in the troubleshooting guide.


This example assumes that your web root is C:/Program Files/Apache Group/Apache2/htdocs/.

Search documentation