How can we help?


atmail installation

Dominic -


How can I install atmail


  • atmail mail server
  • atmail suite


Installation requirement.


The atmail plugin allows administrators to employ the use of an object storage end-point for storage of email attachments. This extends dovecots functionality to now store attachments in object storage based on a domain name and time-stamps. Both of these variables can be determined by the administrator.

Pre-installation notes

System requirements

Before you install the atmail plugin, 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. You can then access atmail by either Screenshot_from_2017-09-29_10-39-15.png or Screenshot_from_2017-09-29_10-39-46.png. Once purchased or trialed, you can download the atmail software package from within the atmail client portal.


  1. Create a backup of your current /etc/dovecot/
    [root@localhost ~]# tar -czvf ~/dovecot_backup.tar.gz /etc/dovecot/
  2. Remove current dovecot packages that are installed during the atmail mail server installation. This will automatically create a backup of dovecot.conf.
    [root@localhost ~]# yum remove dovecot-*
    warning: /etc/dovecot/dovecot.conf saved as /etc/dovecot/dovecot.conf.rpmsave
  3. Install required dependencies from the yum repository.
    [root@localhost ~]# yum install epel-release lz4 bzip2-libs xz-libs clucene-core openssl-1.0.1e hiredis-0.12.1 libxml2 librados2
  4. atmail store(obj) also requires hiredis-0.13. This can be installed directly using the below.
    yum install
  5. Extract the atmail-store-obj.tar.gz package.
    [root@localhost] tar xvfz atmail-store-obj-[version].tar.gz
  6. Enter the atmail-store-obj directory.
    [root@localhost ~]# cd atmail-store-obj-[version]/
    [root@localhost atmail-store-obj-[version]]#
  7. Now use yum to install the dovecot rpm.
    [root@localhost atmail-store-obj-[version]]# yum install dovecot-[version]-0.el7.centos.x86_64.rpm 
  8. Use yum to install the dovecot-pigeonhole.atmail rpm.
    [root@localhost atmail-store-obj-[version]]# yum install dovecot-pigeonhole-[version]-0.el7.centos.x86_64.rp
  9. Use yum to install the dovecot-mysql.atmail rpm.
    [root@localhost atmail-store-obj-[version]]# yum install dovecot-mysql-[version]-0.el7.centos.x86_64.rpm
  10. Copy the dovecot.conf.rpmsave back to dovecot.conf. Restart dovecot and make sure its running.
    [root@localhost atmail-store-obj-[version]]# cp /etc/dovecot/dovecot.conf.rpmsave /etc/dovecot/dovecot.conf
    cp: overwrite ‘/etc/dovecot/dovecot.conf’? y
    [root@localhost atmail-store-obj-[version]]# systemctl restart dovecot
    [root@localhost atmail-store-obj-[version]]# systemctl status dovecot
    ● dovecot.service - Dovecot IMAP/POP3 email server
    Loaded: loaded (/usr/lib/systemd/system/dovecot.service; disabled; vendor preset: disabled)
    Drop-In: /etc/systemd/system/dovecot.service.d
    Active: active (running) since Fri 2017-09-29 11:46:50 AEST; 33s ago
    Docs: man:dovecot(1)
    Process: 1717 ExecStart=/usr/sbin/dovecot (code=exited, status=0/SUCCESS)
    Main PID: 1719 (dovecot)
    CGroup: /system.slice/dovecot.service

You now have an installed and running atmail, but before the system becomes usable, it will require further configuration.

Have more questions? Submit a request


Contact our support team

+61 (7) 5357 6605