How can we help?


Single Node: mail server installation guide

Stewart -

What is mail server

The atmail mail server provides admin users with a GUI to perform many of the admin tasks related to running an email system. 

Some of the functionality provided by the mail server is:

  • the ability to create domains, accounts, sub-domains, and reset passwords.
  • Control settings related to IMAP, POP, and SMTP.
  • Integration of mail server and atmail suite.


The atmail mail server installation files can be used to set up the atmail mail server. This document will illustrate how to configure the mail server software from these files. 


If you are installing both mail server and atmail suite on the same node it please start with the installation of atmail suite first. 

Pre-installation notes

System requirements

Before installing the atmail mail server, please make sure that the system requirements are met.  After returning to this guide from the system requirements section, postfix should have been removed, a working MariaDB instance should be set up and OpenSSL should be installed.  If you have not performed all these steps please navigate back to system requirements.


If you have not already done so, please follow the firewalld guide in the configuration section as this will ensure that the correct ports are opened.  By default, all ports other than 22 will be closed.


First signup as an atmail evaluation user or login to your pre-existing atmail customer portal account. Download the atmail mail server software package from within the atmail client portal.


Installation notes

  1. Extract the atmail-mailserver-rpm.tar.gz package.
    # tar xvzf atmail-mailserver-rpm.tar.gz
  2. Enter the atmail-mailserver directory.
    # cd atmail-mailserver-[version]
    [root@localhost atmail-mailserver-[version]]#
  3. Use yum to install redis.  Then enable and start redis.
    # yum install redis
  4. Then enable and start redis
    # systemctl enable redis
    # systemctl start redis  
  5. Use yum to install exim.
    # yum install exim -y
  6. Use yum to install the atmail-common rpm.
    # yum install atmail-common-[version].el7.centos.x86_64.rpm -y
        Creating group atmail ..... [ OK ]
        Creating user atmail ..... [ OK ]
        Switching SELinux to permissive mode ..... [ OK ]
    Note: If you have already installed the atmail suite, you do not need to re-install atmail-common and this step can be skipped.
  7. Use yum to install the atmail-cosadm rpm
    # yum install atmail-cosadm-[version].x86_64.rpm
  8. Use yum to install the dovecot.atmail rpm, the dovecot-pigeonhole.atmail rpm and the dovecot-mysql.atmail rpm.
    # yum install dovecot*.rpm -y
  9. Use yum to install the atmail-mailserver-ansible rpm.
    # yum install atmail-mailserver-ansible-[version].el7.centos.x86_64.rpm -y
  10. You will notice that atmail-mailserver-ansible-jap-[version].el7.centos.x86_64.rpm has been included in the download, however, this is not needed for single node install and can be safely ignored. 
  11. Use yum to install the atmail-mailserver rpm.
    # yum install atmail-mailserver-[version].el7.centos.x86_64.rpm -y
  12. Configure the atmail mail server.
    1. Run
      1. Enter DB host [ localhost ] : 
      2. Enter DB port [ 3306 ] :
      3. Enter DB Username with GRANT/CREATE ACCESS [ root ] :
      4. Enter DB Username Password [  ] :
      5. Configure Nginx [ yes ] :
      6. Configure PHP-FPM [ yes ] :
  13. OPTIONAL: Use yum to install the atmail-mailserver-plugin-WebmailIntegration rpm (required if also running atmail suite).
    # yum install atmail-mailserver-plugin-WebmailIntegration-[version].el7.centos.x86_64.rpm -y -q
  14. Restart services.
    # systemctl restart php-fpm nginx
  15. Register your license details. Access your installation via your URL hostname slash admin. You will be directed to enter your atmail ID and serial key.

    Default access details
    Username: admin
    Password: admin

    This install uses self-signed certificates, the browser may warn you that the certificate is not trusted, please acknowledge the browser warning and proceed to the admin site.  To configure a new certificate use this guide as a reference.

  16. Go to webadmin > Services and press Publish config.

  17. Restart services.
    # systemctl restart dovecot exim php-fpm nginx
  18. atmail mail server installation complete!

Post-installation notes

Dav Integration

If installing atmail-dav for contacts and calendars, the invites for an out the box install will not work as the dav sender needs to be set in the dav confilg file.  Please follow this link to find the guide explaining how to do this.

Webmail Integration

If installing atmail suite in conjunction with mail server, and you have not already set up their integration, please use the following guide to ensure the correct integration.

PHP Settings

Define your timezone for php by editing php.ini and updating the variable to your timezone as displayed below.

# vi /etc/php.ini
; Defines the default timezone used by the date functions                                           
date.timezone = Australia/Brisbane 

After updating the php.ini file, restart services:

# systemctl restart php-fpm nginx

It is recommend you visit the below for further configuration and setup of your installation:

Have more questions? Submit a request


Contact our support team

+61 (7) 5357 6605