Mailborder Master Server Installation Guide

Mailborder v4.1.9


bouy   Warning: Before You Start


  • Read these instructions carefully and completely. 

  • 95% of our support requests are a result of not reading instructions.

  • Read the manual before asking for support. (Top Menu > Docs > Manual)

  • The supported operating systems and versions are the only operating systems that will work with Mailborder.
monitor black  Install a supported Linux server

Supported Operating Systems

  • CentOS 6
  • Debian 7
  • RedHat 6
  • Ubuntu 14.04 LTS Server (64 bit only)
  • Ubuntu 12.04 LTS Server

Build a server using a supported platform. The Gnome and KDE GUIs should not be installed. Additional packages should not be installed as the Mailborder installer will install all required packages. The newly built server will require Internet connectivity to download the required packages. Mailborder supports both physical and virtual servers and has been tested extensively on VMware vShere (ESXi) v5 and v5.1.

If you are unsure which OS to use, Ubuntu 12.04 LTS is the most tested and stable platform for Mailborder.

redhat black  RHEL6 Requirement


If your server is running RHEL6 it must be subscribed on RHN (or satellite) to the following channels:

Base Channel: Red Hat Enterprise Linux Server
  • Red Hat Common
  • RHEL Server Optional
circuit black  Hardware

Minimum Recommended Hardware (Master)

  • 2+ CPU cores
  • 1024+ MB RAM
  • 40+ GB HDD
bulletlist black  Important Notes
  • Use UTC time (or at least the same time zone) for your Mailborder servers when implementing a Mailborder cluster if the member servers will be in multiple time zones. Failure to do so will result in inaccurate server logging.

  • DO NOT remove iptables. Mailborder uses this package. Removing this package will cause the server to malfunction.

  • DO NOT install third party utilities such as webmin. These utilities can change file permissions or other settings on a Mailborder server and thus cause the server to malfunction. Use of such tools will invalidate any support contracts for your Mailborder server.

  • You should install Mailborder Master servers with a free Community Edition license before purchasing a paid license in the Mailborder store. This will ensure that the license will work with your MAC address.

  • Ensure that your hostname is set correctly in /etc/hostname or /etc/sysconfig/network prior to installing Mailborder. FQDN's should be used as hostnames. Example: Some providers such as Rackspace use short hostnames. Be sure to change it and reboot before installing Mailborder.

  • It is possible to change the IP address of the Mailborder server at a later date. Therefore, you can install the Mailborder server in a lab environment and move it when ready for production.

  • If the server is using openvz with a VENET adaptor, it may not have a MAC address. In this case add a second adaptor using VETH. Make sure that the default route remains on the VENET adaptor. The secondary VETH adaptor does not need to be used. It just needs to exist.
nic black Record the MAC address
  • From the command line of the server, obtain the MAC address by executing ifconfig command.
# ifconfig


  • Copy the MAC address (case sensitive). 
eth0 Link encap:Ethernet HWaddr 00:0C:29:2D:9F:7D
inet addr: Bcast: Mask:
RX packets:8917591 errors:0 dropped:0 overruns:0 frame:0
TX packets:23359 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:639287110 (609.6 MiB) TX bytes:3131708 (2.9 MiB)

  In the above example, the MAC address is 00:0C:29:2D:9F:7D. It does not matter if the server has multiple NICs and MACs. Only one is required to be present on the server for the license to function.

key black Obtain a License Key
  • Create a user account on the Mailborder website if you do not already have an account.

  • Log into the Mailborder website.

  • Navigate to the Store section of the site. (Link on the Main menu.)

  • Select your product and enter the MAC address recorded in the previous step. (Free licenses are also obtained from the Store.)

  • A key will be generated and available under the website left menu as illustrated in the picture. License keys are generated immediately when purchased from the Mailborder store.

  • Download and save the license file. 
dl black Download the Install Script
console black Install Mailborder
  • Copy the install script to a directory to start the installation from. (e.g. /root) 

  • The installer must be run as the root user. As root, unzip the installer and run it.

  • Below is an example using the Ubuntu installer. Change the file names to fit your Linux distribution installer.

# unzip
# sh


  • The installer will require your input for the MySQL root password. Ensure that you record the password! Enter this password again if asked during the install process. (It must match the first entry.)

  • If asked about saving IPv4 firewall rules or what type of site for Postfix, simply accept the defaults by pressing enter.

  • The installer takes 5 to 10 minutes on Debian based systems and 20 to 40 minutes on RedHat based systems to install depending on the speed of the server.
edit property black Record the Setup Key 
  • After the installation is complete a setup key will be displayed on the screen. Copy this key to your clipboard.

  • You can also access the key later on the Mailborder server within this file: /mailborder/system/sKey
window black Reboot and Login
  • Reboot the server after the installation process completes.

  • Once the server comes back up, the GUI can be accessed via a web browser from a workstation. Follow the onscreen instructions to complete the setup.

Change the above IP address or server name to match your server.

Default user: admin
Default password:  secret
checked checkbox black Post Reboot and GUI Install Notes
  • Red Hat and variants have SELinux set to Permissive mode during the installation process. The server may take some time to come back up upon reboot due to indexing. 

  • You must enter at least one IP address on the GUI setup page. It can be either IPv4, IPv6, or both. However, both cannot be left blank.

  • If you receive an Internal Server 500 Error, double check that you selected the correct license key during the GUI setup. Each license is locked to a specific MAC address.

  • Make sure to change the default admin password as soon as you log into the GUI.

Mailborder Privacy and Terms

User information submitted on this site is strictly guarded and not shared with third parties. While transaction information from sales is recorded, credit card information is not stored on Mailborder servers. For a complete overview review Website Terms and Conditions of Use.