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. Extract the atmail-mailserver-rpm.tar.gz package. 
    [root@localhost tmp]# tar xvzf atmail-mailserver-rpm.tar.gz 
  2. Enter the atmail-mailserver directory.
    [root@localhost tmp]# cd atmail-mailserver-[version]
    [root@localhost atmail-mailserver-[version]]#
  3. 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.

  4. Use yum to install the dovecot.atmail rpm.
    [root@localhost atmail-mailserver-[version]]# yum install dovecot.atmail.el7.centos.x86_64.rpm -y -q
  5. 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
  6. 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
  7. 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
    Delta RPMs disabled because /usr/bin/applydeltarpm not installed.
    warning: /var/cache/yum/x86_64/7/epel/packages/libtommath-0.42.0-4.el7.x86_64.rpm: Header V3 RSA/SHA256 Signature, key ID 352c64e5: NOKEY
    Public key for libtommath-0.42.0-4.el7.x86_64.rpm is not installed
    Importing GPG key 0x352C64E5:
     Userid     : "Fedora EPEL (7) <>"
     Fingerprint: 91e9 7d7c 4a5e 96f1 7f3e 888f 6a2f aea2 352c 64e5
     Package    : epel-release-7-9.noarch (@extras)
     From       : /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-7
    warning: /etc/nsswitch.conf created as /etc/nsswitch.conf.rpmnew
        Creating user vmail ..... [ OK ]
    To complete install run atmail-mailserver-install and remove /etc/atmail/mailserver/.master from slave nodes
  8. Configure the atmail mail server.
    1. Run /usr/bin/atmail-mailserver-install 
      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 ] :
  9. 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
    Enabling plugins ..... [ OK ]
    Adding plugin to DB ..... [ OK ]
    Adding in config settings to DB ..... [ OK ]
  10. 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


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

  12. Restart services.
    systemctl restart dovecot
    systemctl restart exim
    systemctl restart php-fpm
    systemctl restart nginx
  13. 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 ~]# vim /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


  • Avatar

    The one thing I found missing was the installation of exim. once I manually installed exim, I was able to restart the service and publish config.

  • Avatar

    Hello Wayne,

    On first click of "Publish config", the exim service will be installed while the config is being published.

  • Avatar

    If we stop Exim and dovecot, spamassassin and clamd daemons are still running.
    Since there is no script like in Atmail7 which would stop/start/restart all services, we must manually stop them via systemd.
    When starting, is the order in which they are started of any importance?
    Clamd --> Exim--> Dovecot--> SpamAssassin

    Edited by Mladen
  • Avatar

    Hello Mladen,

    Thanks for the question.

    As these services are managed via systemd they do not need to be started in a specific order. However something to consider would be Exim and Dovecot momentarily running without Clamd and/or SpamAssassin. It is there for recommend that your anti-spam/virus services are started before IMAP and SMTP.

    Please let me know if I can clarify further.

    Best Regards.

  • Avatar

    After step 8 (skipping step 9, installation of mailserver only) You must start nginx and php-fpm because nginx is not running to server https://yourhostname/admin.
    Installation of version 8.5.0 from scratch.
    Please verify.

Contact our support team

+61 (7) 5357 6605