How can we help?


atmail ActiveSync 2.3.6 Upgrade Guide

Stewart -


I need to upgrade atmail ActiveSync.


  • On-Premise Server + WebMail Installations: Version
  • Webmail Only Installations: Version


ActiveSync upgrade requirement.


Since atmail 7.4, atmail requires an extra package for ActiveSync. With the release of atmail, a newer version of atmail ActiveSync is also available. This package is available for download via the "Downloads" section of your Atmail Customer Portal.


  • atmail
  • apache 2.4 only
  • POSIX (php-process) Extension for PHP
  • atmail must be already installed
  • Valid license to use ActiveSync with atmail
  • Operating System

    Since Atmail ActiveSync is based on PHP, it can be ported into any platform that supports and/or compiles PHP. Currently, Atmail supports the following environments:

    • Redhat Enterprise 7.x only
    • CentOS 7.x only

How to upgrade


You will first need to download the atmail ActiveSync package from within your Atmail Customer Portal. Login at and go to the "Downloads" page. Here you will find a link to download the Atmail ActiveSync package.

Note: The atmail ActiveSync download will only be shown in your atmail Customer Portal if your license allows the use of ActiveSync.


  1. Create /usr/share/push/ directory.

    mkdir /usr/share/push
  2. Place the downloaded file any where on your server and extract as follows.

    tar xfvz -C /usr/share/push/
    Change the file name to match the file you downloaded. Each customer will be provided with a unique file name.
  3. Run atmail ActiveSync installation.

    cd /usr/share/push
    php install.php
  4. At the MySQL Database Setup section, create a new database. A new database is required for the newer verion of ActiveSync.



Re-provision Accounts

After upgrading your ActiveSync installation, user accounts will need to be re-provisioned on their devices. Due to the state machine changes in the latest release re-provisioning is required in order to have the user accounts authenticate against the new database.

Apache 2.4.X

With Apache 2.4.X, you may have a 403 forbiden error. To resolve, you need to add the following into your Apache configuration file.

<Directory /usr/share/push>
Require all granted

Tested Devices

Atmail ActiveSync 2.3.6 has been tested and confirmed working with the following devices, using the default mail applications available on them. Alternate devices that support ActiveSync should work without issue, however untested.

  • Samsung Galaxy s5 with Android 6.0.1
  • Samsung Galaxy s7 Edge with Android 6.0.1
  • Samsung Galaxy s7 Edge with Android 7.0
  • Samsung Galaxy Tab 3 with Android 4.4.2
  • LG Nexus 5 with Android 6.0.1
  • Apple iPhone 6 with iOS 9.3.4
  • Apple iPod 2 with iOS 6.1.6 (10B500) (Notes: Does not support unicode/utf8 characters)
  • Nokia Lumia 635 with Windows OS 8.10.12397.895 [CYAN]

Tested operating systems

  • Centos 7.3.1611 / Apache 2.4; extra dependency installation - php-process.

Known issues

If an account is setup with the Android native app the events do not sync from device to server, when the webmail event timezone is set to "none", the event will be displayed in the webmail as per the timezone settings defined in php.ini.

The php.ini TZ settings are also used when sending the updates to device if no timezone is specified events are stored in GMT and rely on the device converting into local time.

Hardening SMTP

/usr/share/push/backend/imap/config.php; Change 'verify_peer', 'verify_peer_name' and 'allow_self_signed' to TRUE, TRUE and FALSE respectively.

Have more questions? Submit a request


Contact our support team

+61 (7) 5357 6605