Installation tutorial

Installing hMailServer

This page describes the required steps to install hMailServer 5. Before installing hMailServer, you should ensure that your computer fulfills the system requirements.

Step 1: Download

The first step is of to download hMailServer. The installation program is available for download at the download page. It is recommended that you download the latest stable version. The file you download has a name of the form hMailServer-version-build.exe. As an example, version-build might stand for 5.0-Build-305.

Step 2: Install

  • Double-click on the downloaded file to launch the setup. The first dialog which is shown is the Welcome dialog, in this one, simply click Next.

  • The next step is to read the license agreement. If you don't accept the license agreement, please cancel the installation. If you agree, select "I accept the agreement" and click next.


  • Select the destination folder and click Next. You should select a local drive and not a network folder. It is possible to install hMailServer on removable devices, but you will not be able to run hMailServer from the device on another computer.

  • Select which components you want to install and click Next. On the server, you should install all available components. If you have already installed the hMailServer server on another computer and you want to manage that remotely, you only need to install the Administrative tools.

  • Select which start menu folder you want to place the hMailServer icons in and click Next.

  • Confirm that the settings are correct and then click Install to do the installation.

  • Wait... The installation should take about 10-20 seconds.

  • After the files have been installed, you need to provide the installation program with a main hMailServer password. In 4.3 and later, a main password is used to increase security. The password can be anything you like as long as it's longer than 5 characters. You will need the password later on when performing server administration, so don't forget it. You only need to specify the password the first time you install hMailServer

  • After you have finished the installation, it's time to start hMailServer Administrator (found in the start menu). The first thing which appears is the Connect dialog. This dialog allows you to connect to different hMailServer installations in your network. Normally, you will want to connect to localhost. Select localhost, and click Connect. In the password dialog, enter your main hMailServer password and click OK.

Step 3: Post-installation tasks

DNS configuration

After installing hMailServer, make sure you configure your DNS server correctly. For SMTP to work, you must define MX records for your domain. MX stands for Mail eXchanger. Simply put, the MX records tell other email servers what server in your domain is responsible for handling mail. Here is more information about MX records.

Firewall / Router

You are additionally likely required to open incoming ports in your software firewall on the machine that hMailserver is installed. You should NOT allow access for the hMailsevrer program, just open the ports required for mail transfer to your server.

You will need to forward incoming ports from your router / Hardware firewall to the machine with hMailsevrer installed.

Standard ports are:-

Usage Port Recommended Security if SSL Certificate installed
SMTP 25 StartTLS (Optional)
SMTP Submission 587 StartTLS (Required)
POP3 110 StartTLS (Required)
IMAP 143 StartTLS (Required)


Step 4: Configuring the server

The tutorial for configuring the server is found here.

If you are experiencing any problems, please read the troubleshooting guide.

Search documentation