How can we help?


atmail mail server upgrade guide

Dominic -


To upgrade atmail mail server to the latest version.

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

If upgrading both atmail server and suite, it is recommended to upgrade atmail suite first.


Keeping your atmail installation up-to-date should be prioritised so your system can benefit from our latest technologies and security features.

Pre-Upgrade Tasks

  1. Ascertain current version.
    # rpm -qa atmail-mailserver
  2. Backup database.
    # mysqldump -u root -p -d mailserver > mailserver-`rpm -qa atmail-mailserver | sed 's/-/ /g' | awk '{print $3}'`_`date +"%Y%m%d"`.sql
  3. Backup mailserver. For your convenience the following command will create a mailserver-version_date.tgz
    # tar cfvz mailserver-`rpm -qa atmail-mailserver | sed 's/-/ /g' | awk '{print $3}'`_`date +"%Y%m%d"`.tgz mailserver-[version_date].sql /etc/atmail/mailserver /etc/nginx/conf.d/atmail-mailserver.locations /var/lib/atmail/mailserver /var/lib/atmail/dovecot /usr/share/atmail/mailserver/
    -rw-r--r--. 1 root root 10476305 Jul 21 13:02 mailserver-1.0.0_20170721.tgz

This is required before you upgrade in case you need to roll-back any changes, please do not skip this step.


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. Update to the latest base packages supplied by CentOS to ensure all the latest security and stability packages are applied:
    # yum update -y mariadb mariadb-server openssl openssl-libs exim nginx php php-fpm
  2. If you have not already done so, please install redis:
    # yum install redis
  3. Extract the atmail-mailserver-rpm.tar.gz package.
    # tar xvzf atmail-mailserver-rpm.tar.gz

  4. Enter the atmail-mailserver directory.
    # cd atmail-mailserver-[version]
    [root@localhost atmail-mailserver-[version]]#
  5. Use yum to update the atmail-common rpm.
    # yum update 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.
  6. Use yum to update the atmail-mailserver-ansible rpm.
    # yum update atmail-mailserver-ansible-[version].el7.centos.x86_64.rpm -y -q
  7. Use yum to install the atmail-cosadm.
    # yum install atmail-cosadm-[version].x86_64.rpm -y -q 
  8. Use yum to update the atmail-mailserver rpm.
    # yum update atmail-mailserver-[version].el7.centos.x86_64.rpm -y -q
  9. OPTIONAL: Use yum to update the atmail-mailserver-plugin-WebmailIntegration rpm (required if also running atmail suite).
    # yum update atmail-mailserver-plugin-WebmailIntegration-[version].el7.centos.x86_64.rpm -y -q
  10. Use yum to install the atmail-mailserver-ansible-jap.
    # yum install atmail-mailserver-ansible-jap-[version].centos.x86_64.rpm -y -q
  11. Restart services.
    # systemctl restart dovecot php-fpm nginx
  12. Using the browser navigate to the following address: https://yourhostname/admin/.VERSION.
    Open the file using a text editor and ensure is show the version number as 8.7.12
  13. atmail mail server upgrade complete!
Have more questions? Submit a request


Contact our support team

+61 (7) 5357 6605