My activities New request

contact atmail support

PH: +61 (7) 5357-6605

support@atmail.com

Follow

atmail mail server

Stewart -

PROBLEM

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

ENVIRONMENT

  • atmail mail server

CAUSE

Installation requirement.

RESOLUTION

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.

Download

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.

portal-downloads.png

Installation notes

  1. Extract the atmail-mailserver-rpm.tar.gz package. 
    [root@localhost tmp]# tar xvzf atmail-mailserver-rpm.tar.gz 
    atmail-mailserver/
    atmail-mailserver-[version]/atmail-dav[version].el7.centos.x86_64.rpm
    atmail-mailserver-[version]/dovecot-pigeonhole[version].atmail.el7.centos.x86_64.rpm
    atmail-mailserver-[version]/atmail-mailserver[version].el7.centos.x86_64.rpm
    atmail-mailserver-[version]/dovecot-mysql[version].atmail.el7.centos.x86_64.rpm
    atmail-mailserver-[version]/atmail-common[version].el7.centos.x86_64.rpm
    atmail-mailserver-[version]/atmail-mailserver-plugin-WebmailIntegration[version].el7.centos.x86_64.rpm
    atmail-mailserver-[version]/dovecot[version].atmail.el7.centos.x86_64.rpm
  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) <epel@fedoraproject.org>"
     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. OPTIONAL: Use yum to install the atmail-dav rpm.
    [root@localhost atmail-mailserver-[version]]# yum install atmail-dav[version].el7.centos.x86_64.rpm -y -q
    Generating self-signed cert
    Note: If you have already installed the atmail suite, you do not need to re-install atmail-dav and this step can be skipped.

  11. Configure the atmail DAV server

    Note: If you have already installed the atmail suite, you do not need to re-configure the atmail-dav server and this step can be skipped.
    1. Run /usr/bin/atmail-dav-install
      1. Enter DB Host [ localhost ] :
      2. Enter DB Port [ 3306 ] :
      3. Enter DB user that has create user/grant access [ root ] :
      4. Enter root password [  ] :
      5. Configure NginX [ yes ] :
      6. Configure PHP-FPM [ yes ] :

  12. 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

    https://yourhostname.com/admin/
    Username: admin
    Password: admin

    register-license-key.png

  13. Go to webadmin > Services and press Publish config.
    publish-config.png

  14. Restart services.
    [root@localhost ]# systemctl restart dovecot
    [root@localhost ]# systemctl restart exim
    [root@localhost ]# systemctl restart php-fpm
    [root@localhost ]# systemctl restart nginx
  15. atmail mail server installation complete!

Have more questions? Submit a request

Comments

  • Avatar
    Wayne

    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
    Stewart

    Hello Wayne,

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