MailSuite Pro documentation

Installation instructions

Starting from version 9.8, MailSuite Pro is available as a native .DEB package which can be installed on any modern Ubuntu or Debian compatible Linux distribution. The recommended approach is to install the product from our APT repository.

The package has been tested with the following operating systems: Ubuntu Linux 20.04, 22.04, 24.04, 24.10; Debian Linux 11 and 12; Linux Mint 21.3 and 22; MX Linux 23.3.

If you're running a different modern Ubuntu/Debian-based distribution and encounter any issues with it, please let us know via HelpDesk.

NB: Make sure you're installing the product onto a blank Linux system without any kind of hosting control panel software, web/mail/database servers running there.

Installing from repository

All the commands need to be performed either as root user or as super user. On Debian, you may need to install a few prerequisites first:

apt install curl gnupg

Add the repository to your system as follows:

echo "deb http://apt.afterlogic.com/stable /" > /etc/apt/sources.list.d/afterlogic.list
curl -s http://apt.afterlogic.com/afterlogic.asc | gpg --no-default-keyring --keyring gnupg-ring:/etc/apt/trusted.gpg.d/afterlogic.gpg --import
chmod 644 /etc/apt/trusted.gpg.d/afterlogic.gpg

Update your repository cache with:

apt update

And install the package - all the dependencies will be installed automatically:

apt install mailsuite-pro

Manual installation

Alternately, the package can also be installed manually by downloading it from our website. Before doing so, however, you would need to install the dependencies manually as well:

apt update
apt install dovecot-core dovecot-imapd dovecot-lmtpd dovecot-managesieved dovecot-mysql dovecot-pop3d dovecot-sieve dovecot-solr exim4-base exim4-config exim4-daemon-heavy exim4 spamassassin nginx sudo python3-mysqldb mysql-server php-cli php-curl php-common php-fpm php-gd php-json php-mbstring php-mysql php-opcache php-readline php-xml
wget https://afterlogic.com/download/mailsuite-pro.deb
dpkg -i ./mailsuite-pro.deb

Installing a legacy package

Prior to version 9.8, the product was available as Ansible installer, and we still offer it as a legacy edition. This installation method requires Ubuntu 22.04 and is not guaranteed to work on any other system.

  1. Download the installer:
curl https://afterlogic.com/download/aurora-products-mta-installer.tar.bz2 -o aurora-products-mta-installer.tar.bz2
  1. Install the prerequisites:
sudo apt install ansible unzip bzip2 -y
  1. Unpack the installer:
tar jxvf aurora-products-mta-installer.tar.bz2
chmod 0755 -R ./aurora-products-mta-installer
cd aurora-products-mta-installer/
  1. Start the installation process:
sudo ansible-playbook install.yml

Installing antivirus package

MailSuite Pro can be integrated with ClamAV antivirus, but due to its high resource usage, antivirus isn't included in the package. You can install it additionally, just make sure your system has 4Gb RAM or more. Per our experience, configurations like 2Gb RAM and 2Gb swapfile would work as well.

  1. Install and reconfigure ClamAV package:
apt update
apt install clamav clamav-daemon clamav-freshclam
dpkg-reconfigure clamav-daemon

When running dpkg-reconfigure, it should be safe to leave all the default configuration values. However, the following questions should be answered by supplying afterlogic value in a response:

  • Group owner of clamd local (UNIX) socket
  • User to run clamav-daemon as
  • Groups for clamav-daemon (space-separated)

  1. Edit /etc/clamav/freshclam.conf file and supply afterlogic as a value for DatabaseOwner.

  2. Assign correct permissions:
chown afterlogic: -R /var/lib/clamav/
chown afterlogic: -R /var/log/clamav/
chown afterlogic: -R /opt/afterlogic/var/run/dovecot/
  1. Now you should be able to download virus database and restart ClamAV:
freshclam
service clamav-daemon restart
  1. Edit /etc/exim4/exim4.conf file; locate the following line in it:
spamd_address = 127.0.0.1 783

and supply this line before it:

av_scanner = clamd:/var/run/clamav/clamd.ctl

Then locate the following line:

acl_check_data:

and add right after it:

# Virus scanning
  deny  malware = *
        message = This message contains a virus ($malware_name) and has been rejected
        log_message = Virus found: $malware_name
service exim4 restart

Restart Exim service to apply changes:

service exim4 restart

You can test this by sending Eicar test signature:

X5O!P%@AP[4\PZX54(P^)7CC)7}$EICAR-STANDARD-ANTIVIRUS-TEST-FILE!$H+H*

in a plaintext mail message, then monitor /opt/afterlogic/var/log/exim/eximmain.log file, which should indicate "...rejected after DATA: Virus found: Eicar-Signature"

Installing antivirus for legacy package

curl -O https://afterlogic.com/download/add-clamav-ubuntu.tar.bz2
tar jxvf add-clamav-ubuntu.tar.bz2
cd add-clamav-ubuntu/
sudo ansible-playbook install-clamav.yml

Finalizing the installation

Once the installation is completed, you should be able to access the web interface via URL of the server with /adminpanel/ appended to it and proceed with configuring the product. Default admin login is superadmin, with an empty password.

Make sure you have primary hostname of your mailserver installation specified in /etc/exim4/exim4.cnf file, e.g.:

primary_hostname = yourdomain.com

Restart Exim service to apply changes:

service exim4 restart
© Copyright 2002-2025 Afterlogic Corp.