How can we help?


atmail mail server installation guide

Stewart -


How can I install the atmail mail server onto my own server?


  • atmail mail server


Installation requirement.


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

Pre-installation notes

System requirements

Before you install the atmail mail server, please make sure you meet the minimum system requirements.


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. If an upgrade, update to the latest base packages supplied by CentOS to ensure all the latest security and stability packages are applied:
  2. [root@localhost tmp]# yum update -y mariadb mariadb-server openssl openssl-libs exim nginx php php-fpm
    If you are using redis (optional):
  3. [root@localhost tmp]# yum update -y redis
  4. Extract the atmail-mailserver-rpm.tar.gz package.
    [root@localhost tmp]# tar xvzf atmail-mailserver-rpm.tar.gz
  5. Enter the atmail-mailserver directory.
    [root@localhost tmp]# cd atmail-mailserver-[version]
    [root@localhost atmail-mailserver-[version]]#
  6. Use yum to install the atmail-common rpm.
    [root@localhost atmail-mailserver-[version]]# yum install atmail-common[version].el7.centos.x86_64.rpm -y -q
        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 dovecot.atmail rpm.
    [root@localhost atmail-mailserver-[version]]# yum install dovecot.atmail.el7.centos.x86_64.rpm -y -q
  8. Use yum to install the dovecot-pigeonhole.atmail rpm.
    [root@localhost atmail-mailserver-[version]]# yum install dovecot-pigeonhole.atmail.el7.centos.x86_64.rpm -y -q
  9. Use yum to install the dovecot-mysql.atmail rpm.
    [root@localhost atmail-mailserver-[version]]# yum install dovecot-mysql[version].atmail.el7.centos.x86_64.rpm -y -q
  10. Use yum to install the atmail-mailserver-ansible rpm.
    [root@localhost atmail-mailserver-[version]]# yum install atmail-mailserver-ansible-[version].el7.centos.x86_64.rpm -y -q
  11. Use yum to install the atmail-mailserver rpm.
    [root@localhost atmail-mailserver-[version]]# yum install atmail-mailserver[version].el7.centos.x86_64.rpm -y -q
  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).
    [root@localhost atmail-mailserver-[version]]# yum install atmail-mailserver-plugin-WebmailIntegration[version].el7.centos.x86_64.rpm -y -q
  14. Restart services.
    systemctl restart dovecot
    systemctl restart php-fpm
    systemctl restart 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

  16. Go to webadmin > Services and press Publish config.
  17. Restart services.
    systemctl restart dovecot
    systemctl restart exim
    systemctl restart php-fpm
    systemctl restart nginx
  18. atmail mail server installation complete!

Post-installation notes

PHP Settings

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

[root@a8 ~]# vi /etc/php.ini
; Defines the default timezone used by the date functions                                           
date.timezone = Australia/Brisbane 

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

Have more questions? Submit a request


Contact our support team

+61 (7) 5357 6605