Mailborder Portal Server Installation Guide

Mailborder v4.1.9


checked checkbox black  Requirement Check

Master Server

A Mailborder Master server at version 4.1.1 or greater must exist before installing a Mailborder Portal server. The Master server must be one of the following classes:

  • Hosting
  • Enterprise
  • Ultimate
circuit black  Hardware

Minimum Recommended Hardware (Portal)

  • 2+ CPU cores
  • 512+ MB RAM
  • 40+ GB HDD 
monitor black  Install a supported Linux server

Supported Operating Systems

  • CentOS 6.x
  • Debian 7
  • Red Hat Enterprise 6.x
  • Ubuntu 12.04 LTS Server
  • Ubuntu 14.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.

** It is recommended that you do install the SSH server service.
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
folder internet black  Register the Portal Server

Master Server Tasks

Task #1

  • Log into the Mailborder Master server for the cluster.

  • Navigate to: Left Menu > Mailborder Servers

  • Click Add Server

  • Enter the FQDN and the IP address of the Portal server.

  • Select Portal as the server type.

  • Click Add Server
Task #2
  • Navigate to: Left Menu > Server Templates > Relay Templates > (the relay template used by the Master server)

  • Go to: Manually Add > Enter the IP address (not the hostname) of the Portal server.

  • Click Save

  • Ensure that the Add Firewall Rule and Configuration Rebuild tasks have completed on the Master server before continuing.
edit property black  Record Installation Data 
You will need to have the following information available before starting the install process.

  • The Master server's IPv4 or IPv6 address.
  • The Portal Server GUID assigned by the Master server.
  • The Portal Server DB User assigned by the Master server.
  • The Portal Server DB Password assigned by the Master server.

To obtain the GUID, DB User, and DB Password, navigate to the following location on the Master server:

  • Left Menu > Mailborder Servers

  • (Portal Server Name) > DB User > View
bulletlist black  Important Notes
  • 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 Portal product and enter the MAC address recorded in the previous step.

  • 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
  • Install wget and unzip via yum or apt-get if it is not already installed.
  • # apt-get install wget unzip or yum install wget unzip


  • Download the installer using the appropriate wget command below directly from the new Mailborder server:

CentOS 6.x
# wget

Debian 7
# wget

RHEL 6.x
# wget

Ubuntu 12.04 LTS
# wget

Ubuntu 14.04 LTS
# wget

console black Install the Mailborder Portal
  • 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


  • If asked about saving firewall rules, simply accept the defaults by pressing enter.

  • The installer takes 5 to 10 minutes depending on the speed of the server.
window black Reboot and Validate
  • Reboot the server after the installation process completes.

  • Once the server comes back up, access the Portal via a web browser. Example: or 

  • Follow the instructions on the screen to complete the setup.
checked checkbox black Post Reboot and GUI Install Notes
  • If the Portal server is not able to contact the Master server, ensure that a valid path exists between the servers. Communication over port 3306 TCP is required.

  • An entry is made to /etc/hosts which has the Master server IP address with the hostname mailborder-master. Do not remove this entry.

  • For troubleshooting you can view the error logs on each server here: /mailborder/logs 

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.