How can we help?


atmail store(obj) installation

Dominic -


How can I install atmail store (obj) ?


  • atmail mail server
  • atmail suite


Installation requirement.


The atmail store(obj) 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 store(obj) 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 store(obj) 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 store(obj) software package from within the atmail client portal.



  1. Create a backup of your current /etc/dovecot/
    [[email protected] ~]# 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.
    [[email protected] ~]# yum remove dovecot-*
    warning: /etc/dovecot/dovecot.conf saved as /etc/dovecot/dovecot.conf.rpmsave
  3. Install required dependencies from the yum repository.
    [[email protected] ~]# 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.
    [[email protected]] tar xvfz atmail-store-obj-[version].tar.gz
  6. Enter the atmail-store-obj directory.
    [[email protected] ~]# cd atmail-store-obj-[version]/
    [[email protected] atmail-store-obj-[version]]#
  7. Now use yum to install the dovecot rpm.
    [[email protected] atmail-store-obj-[version]]# yum install dovecot-[version]-0.el7.centos.x86_64.rpm 
  8. Use yum to install the dovecot-pigeonhole.atmail rpm.
    [[email protected] 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.
    [[email protected] 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.
    [[email protected] atmail-store-obj-[version]]# cp /etc/dovecot/dovecot.conf.rpmsave /etc/dovecot/dovecot.conf
    cp: overwrite ‘/etc/dovecot/dovecot.conf’? y
    [[email protected] atmail-store-obj-[version]]# systemctl restart dovecot
    [[email protected] 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 store(obj), 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       [email protected]