help centre
For more info visit status.atmail.com

How can we help?


Search our knowledge base for answers to
common questions and latest updates.



My activities New request

Follow

atmail mail server installation guide

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]/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. 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

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

  12. Restart services.
    [root@localhost ]# systemctl restart dovecot
    [root@localhost ]# systemctl restart exim
    [root@localhost ]# systemctl restart php-fpm
    [root@localhost ]# 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
[Date]                                                                                              
; Defines the default timezone used by the date functions                                           
; http://php.net/date.timezone                                                                      
date.timezone = Australia/Brisbane 

It is recommend you visit the below for further configuration of your installation:

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.

  • Avatar
    Mladen

    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
    Dominic

    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.


Contact our support team


+61 (7) 5357 6605       support@atmail.com