How can we help?


Atmail 6.X to Atmail 7.7.1 WebMail Client Only Upgrade

Stewart -

I'm not sure how to upgrade my Atmail 6 WebMail Client only install to Atmail 7.


  • Webmail Only Installations: Version 6.0 > 7.7.1

Atmail needs to be upgraded to the latest version.


This guide will take you through the steps to upgrade Atmail 6 WebMail Client to Atmail 7.7.1 WebMail Client.

Atmail 7.2+
PHP 5.3+ required for 7.2.0+

Note: The upgrade and migration scripts have been used for production systems and considered stable.

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

Upgrading will remove your custom branding.

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

Preparing MySQL

Most Atmail 6 installations use the database name 'atmail6'.Do the following to transfer data from database 'atmail6' into a new database 'atmail7'.

Dump the MySQL database

mysqldump -u root -p atmail6 > /var/www/html/atmail/atmail6-dump.sql

Import the Atmail database.

Log into MySQL and create new database 'atmail7' to insert the dump into.

mysql -u root -p
mysql> create database atmail7;

Log out of MySQL and import the dump into the 'atmail7' database.

mysql -u root -p atmail7 < /var/www/html/atmail/atmail6-dump.sql

Update Atmail MySQL Settings

Open and edit /var/www/html/atmail/config/dbconfig.ini


database.params.dbname   = "atmail6"

Change To:

database.params.dbname   = "atmail7"


Download the latest atmail 7.7.1 tarball via the following URL.


Step 1

Extract the .tgz out into the directory for Atmail.

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

Step 2

You will now need to give Atmail correct permissions.

chown -R [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 {} \;

Step 3

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.

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/upgrade/client-update.php

Step 5

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

If you pick up any bugs or other problems with the new update please create a support ticket at: - Login with your existing account and password.


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 6.3.3; Login to your Atmail database and execute the following command.

mysql> update Config set keyValue = "6.3.3" 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.

php server-update.php

Licensing Issues

No available license seats. Please add more seats.

Clients upgrading from Atmail 6 to Atmail 7 may experience this error message upon installation:
No available license seats. Please add more seats.

If you experience this issue, please go to WebAdmin > Settings > Global Settings, and click on Save Settings (as per the following screenshot):

Doing so should fix the issue.

Error: License Invalid or No License Installed.

Clients upgrading from Atmail 6 to Atmail 7 may experience this error message upon installation:

Error: License Invalid or No License Installed.

If you experience this issue, please the following command via MySQL:

mysql>select licenseType from Groups;


mysql> select licenseType from Groups;
| licenseType |
|           0 |
|           0 |
|           0 |
|           0 |
|           0 |
|           5 |
|           0 |

Note that '0' is not a vaild licenseType. To resolve, update licenseType to match your license.


mysql> update Groups set licenseType='5';


Contact our support team

+61 (7) 5357 6605