Email Spam Filter Server Installation

ubuntu mail filter install

Mailborder Server Installation


Summary of Steps:

  • Install a supported operating system
  • Setup DNS Requirements
  • Run the repository installation script
  • Install via the system package manager
  • Create a Mailborder account on this website
  • Obtain a Mailborder license code via the store


It is highly recommended that you review the entire installation guide before starting. We try to make our guides as concise as possible, so if it is on this page, it is important.

Supported Operating Systems

The following operating systems are supported by Mailborder. Any variant of these operating systems will also work. For example, Elementary OS Juno is based on Ubuntu 18.04 LTS. Therefore, it may be used with Mailborder.

Operating System Version/Release
Ubuntu 18.04 LTS (preferred) Bionic 64 bit
Ubuntu 16.04 LTS Xenial 64 bit

More operating systems may be added at a later date, such as Debian 10 Buster and Red Hat 8 when a Mailborder package becomes available.

Critical: DNS Requirements

Do not skip this section. If you attempt to do this installation without reading the linked document below, your installation will fail.

Mailborder v5 uses FQDNs to access the Master server interface and for communication between Master and Child servers. It is critical DNS is setup before installing the software. The Master interface is not accessible via IP address.

Read: DNS Requirements

Critical: Firewall Requirements

Do not skip this section. If you attempt to do this installation without reading the linked document below, your installation will fail.

Mailborder requires a variety of outbound ports to be open for the installation. Also, Mailborder does not provide inbound firewall protection. If you wish to have your Mailborder installation protected by a firewall (recommended) you will need to set this up either on a separate resource or via the operating system.

Read: Firewall Requirements

Recommended Hardware

Hardware requirements are going to vary depending on email volume, quarantine retention, and archive retention. You may use physical or virtual servers. The more database inserts on the Master server and the heavier the use of the User Portal will determine your CPU requirements for a smooth experience. Child servers not only provide high availability, but they also relieve the Master server of the heavy load of processing email. Below are some recommendations:

Master and Child Servers
Minimum 2 4GB 60GB
Recommended 4 8GB 120GB
Heavy Use 8 16-64GB 240-400GB

Recommended Antivirus Enhancements

Mailborder comes preinstalled with Clam AV Antivirus with additional zero-day signatures. However, we do highly recommend a second virus scanner. When a new virus is introduced into the wild, it takes time for antivirus vendors to get the signatures pushed out. If you install a second or even third virus scanner, Mailborder will use all of them scanning the same email multiple times with different virus scanners. Below is a list of recommended add-ons. We don’t sell licenses for them, but we provide links to the websites where you can purchase them.

Eset for Linux File Servers
This is the antivirus we recommend the most.  This is a very effective virus scanner, but it is not as fast as Dr. Web and Clam AV. It does not have a trial period, but is a low-cost addition with effective detection and prompt signature updates. More Info

Dr. Web
This is a good virus scanner, but it doesn’t seem to detect the newest virus strains as fast as Eset. It is the most cost effective and fastest add-on antivirus we support. More Info

This is a free virus scanner, but is slow in scanning speed. You would not want to use this on a server that processes large volumes of email due to the slow scanning speed. Also, the signature update frequency is not as good as Eset or Dr. Web. If you have the budget to purchase one of the above add-on virus scanners, we recommend that you do so. If you do not, then Sophos is a valid free alternative if your Mailborder server is not very busy. More Info


To help you find the model you need, see our complete Master Server Capability Matrix and the license calculation guide. Then select your server license from the Mailborder store. Trial licenses are available.

Adding the Mailborder Repository

Mailborder is installed via your server’s package manager apt (Debian/Ubuntu). Our repository must first be added to your server’s configuration. As the root user or via sudo, use the setup script to add the Mailborder repository:

cd /tmp
chmod +x
sudo ./

Master Installation

Run this command to install the Master software:

sudo apt-get install mailborder-master

Follow the remaining directions within the setup program. Ensure that the server is rebooted once the installation is complete.

* When asked about the configuration type for Postfix, select “No Configuration“.
* If asked about opendmarc database configuration, select <No>
* Chrome users read this! – Chrome will stop Ajax calls over HTTPS on a self-signed certificate. This means that while you can access the interface, parts of it will not work. To correct this issue, see this article. It is best to install a valid SSL certificate after the installation is complete within the Mater GUI.

Child Installation

The installation steps for the Child server are the same as the Master server. However, you will need to add the Child server to the Master server’s cluster first.

Master Menu > Cluster > Member Servers > Add

Again, the DNS Requirements must be met prior to installing the software. Run this command to install the Child software:

sudo apt-get install mailborder-child

Follow the remaining directions within the setup program.

* When asked about the configuration type for Postfix, select “No Configuration“.
* If asked about opendmarc database configuration, select <No>
* During setup please read carefully. When asked for the API hostname and GUID, make sure you supply the correct ones.

Migrating a v4 to v5 Master Server

You can migrate some of your configuration data from v4 to v5. This includes domains, networks, email forwards, white lists, and black lists. For more information see How to Migrate v4 data to v5.