How can we help?

Watch this space: Upcoming Help Centre Migration


Upgrade to Atmail 7.8.0+ - WebMail Client Only

Stewart -

I'm not sure how to upgrade my Atmail WebMail Client Only install.


Atmail needs to be upgraded to the latest version.


This tutorial will demonstrate how to upgrade an existing Atmail WebMail Client 7.7.1 installation to the latest Atmail version.

Atmail 7.8.0+
PHP 5.4+ required for 7.8.0+



Before proceeding it is strongly recommended that you make a backup of your current Atmail installation.

Upgrading will remove any personal customization's and your custom branding.

mysqldump -u root -p atmail7webmail > /var/www/html/atmail/atmail7[version]-backup.sql
tar cfvz atmail7[version]-backup.tgz /var/www/html/atmail /etc/httpd/conf/httpd.conf

Where /var/www/html/ is the base document root of your server where your installation of Atmail is located.

This is required before you upgrade in case you need to roll-back any changes, do not skip this step.

Any customizations to Atmail (PHP, HTML) must be backed up. The upgrade process will overwrite any modifications, and these must be merged in after the upgrade.


Download the latest atmail tarball via your customer portal downloads section.


Step 1

Extract the .tgz out into the directory for Atmail.

cd /var/www/html/
tar xfvz atmail7.webmail.tgz -C /var/www/html/

Where /var/www/html/ is the base document root of your server where your installation of Atmail is located.

Step 2

You will now need to give Atmail correct permissions.

chown -R [web-server-user]:[web-server-user] /var/www/html/atmail/
cd /var/www/html/atmail/
find . -name .htaccess -exec chown root:root {} \;
find . -name .htaccess -exec chmod 644 {} \;

Where [web-server-user] is the user that runs Apache. Where /var/www/html/ is the base document root of your server where your installation of Atmail is located.

Step 4

Visit the WebAdmin of Atmail and use the Update software link. This will guide you through the web-based upgrade utility for the database schema updates and config changes:


Where is the URL of the Atmail software on your server.

Login to Web Administration using your admin username/password, then click the License tab > Update software.

Note: Available Version will indicate the version available on your server. Please ensure steps previous steps are completed before moving to the WebAdmin upgrade.

Step 4

Depending on the software update, additional packages may need to be re-installed or re-compiled if you are using the Email Server version of Atmail. If prompted during the Web Admin upgrade, run the additional upgrade utility from a command-line:

cd /var/www/html/atmail/
php ./utilities/update/client-update.php

Step 5

Congratulations, the upgrade is now complete. You can now reload the Webmail interface of Atmail and begin using the Atmail 7 version.

If you've made any customizations to the HTML templates, images, or source-code, these changes will need to be copied back in after the upgrade. We recommend using the “diff” command-line utility to compare any local customizations to the Atmail 7 version.


Apache 2.4+

Add a Directory directive as follows (/etc/httpd/conf.d/atmail-webmail.conf):

<Directory "/var/www/html/webmail/">
Options ExecCGI FollowSymLinks
AllowOverride All
Order allow,deny
Allow from all
Require all granted

Where /var/www/html/webmail/ is the path to your webmail only installation.

Force Re-Run Upgrade

If you run into any troubles with the upgrade you may need to re-run the upgrade process.

Assuming that your last version was 7.7.1; Login to your Atmail database and execute the following command.

mysql> update Config set keyValue = "7.7.1" where keyName = "version";

This will fool the WebAdmin update scripts and enable re-running the sql schema updates via the WebAdmin > License > Update Software.

Following the success of the WebAdmin update, please then execute the server-update.php file as the update page will instruct you.

cd /var/www/html/atmail/
php ./utilities/update/client-update.php


Contact our support team

+61 (7) 5357 6605