How can we help?




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.

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-[version]/
    ./atmail-mailserver-[version]/RPM-GPG-KEY-atmail
    ./atmail-mailserver-[version]/atmail-mailserver-plugin-WebmailIntegration-[version].el7.centos.x86_64.rpm
    ./atmail-mailserver-[version]/atmail-cosd-[version].x86_64.rpm
    ./atmail-mailserver-[version]/atmail-common-[version].el7.centos.x86_64.rpm
    ./atmail-mailserver-[version]/atmail-cosadm-[version].x86_64.rpm
    ./atmail-mailserver-[version]/dovecot-mysql-[version].atmail.el7.centos.x86_64.rpm
    ./atmail-mailserver-[version]/atmail-mailserver-[version].el7.centos.x86_64.rpm
    ./atmail-mailserver-[version]/atmail-mailserver-ansible-[version].el7.centos.x86_64.rpm
    ./atmail-mailserver-[version]/dovecot-[version].atmail.el7.centos.x86_64.rpm
    ./atmail-mailserver-[version]/dovecot-pigeonhole-[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-ansible rpm.
    [root@localhost atmail-mailserver-[version]]# yum install atmail-mailserver-ansible-[version].el7.centos.x86_64.rpm -y -q
  8. 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
  9. 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 ] :
  10. 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
  11. Restart services.
    systemctl restart dovecot
    systemctl restart php-fpm
    systemctl restart nginx
  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

    RegisgterLicense.png
  13. Go to webadmin > Services and press Publish config.
    publish-config.png
  14. Restart services.
    systemctl restart dovecot
    systemctl restart exim
    systemctl restart php-fpm
    systemctl restart nginx
  15. 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 ~]# vi /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


Contact our support team


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