How can we help?


WebMail Client Only Installation

Stewart -

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


  • Webmail Only Installations: Current Version

Atmail has not yet been installed.


This document will explain how to install your Atmail WebMail Client software (version 7 and beyond) utilizing its simple, web-based, installation script. The Atmail WebMail Client should be installed when you wish to use Atmail's WebMail software with your existing mail services.

NOTE: You must have an existing IMAP or IMAP/SSL server, and an existing SMTP server to run the WebMail Client software. If you wish to setup Atmail as a complete mail server, please refer to the  Server + WebMail Installation.

Pre-Installation Notes

System Requirements

Before you install Atmail please make sure you meet the minimum WebMail Client System Requirements.

PHP notes

Atmail 7.8+
PHP 5.4+ required for 7.8.0+

Some systems may not have PHP installed. The PHP binary is required for the installation process, and can be installed via binaries available for download on your system. For example, Debian-based systems use the package php5-cli, while RedHat-based systems may use 'php'.

RedHat-based systems
yum install php
Debian-based systems
apt-get install php5-cli

It is also important that you set a default timezone for your PHP installation. This can be done by looking at your /etc/php.ini file (or equivalent), and looking for the following line:

;date.timezone =

This can be set to your own timezone.

date.timezone = Australia/Sydney

Installation Notes


First signup as an Atmail evaluation user or download the Atmail WebMail software from the Atmail client portal.

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

After downloading the software, unpack it to your Document Root.

tar zvxf atmail7.webmail.tgz -C /var/www/html/

Atmail WebMail Client needs to be installed under your web server's DocumentRoot, or VirtualHost directory (these can be found in your apache configuration file). Here is a rough guide to a few distribution defaults:

  • Red Hat based distributions : /var/www/html (default user is apache)
  • Debian based distributions : /var/www/apache2-default (default user is www-data)

Next, change the ownership of the directory to the web server user. This is required for Atmail to save configuration files via the web and used during the install process. For example:

chown -R apache:apache /var/www/html/atmail/

Web-Based Installation

Go to the Atmail WebMail root directory via your browser. Relative to where you placed Atmail, this should be under /Path-to-DocumentRoot/atmail/. For example, if you unpacked Atmail in /var/www/html, and that directory was accessible via, the URL to access Atmail would be

When accessing the page, you should see the following:

Verify that all the required modules are installed. If required modules are missing, install them manually via your servers command line.


RedHat-Based Systems
yum install php-mbstring

Restart apache (or start it if it was not running):

systemctl restart httpd.service
Debian-Based Systems
apt-get install php-mbstring

Restart apache (or start it if it was not running):

apachectl restart

Modules marked as optional do not have to be installed right away, but may make your AtMail installation much more effective.

Should you be satisfied, click “Continue »”. This should present you with the following:

Should you agree to the License Agreement, click on the checkbox, then Continue. You will then be prompted for MySQL details, as per the following:

Place your MySQL information in the input boxes above. Make sure that the username you assign has:

a.) access to the MySQL database you want to use, or
b.) has permissions to create new databases.

Once satisfied, click on Continue. The next step we will set the Password and session storage:

In this step we will set the password and session storage mode.

Atmail can use two way encrypted user session data.

A master key must be provided for this purpose.
This key is VERY IMPORTANT and should have a SECURE BACKUP made.

You MAY skip this step by entering "PLAIN" in this field, however the
system will store user session data in base 64 encoded PLAIN TEXT
so this is NOT recommended.

Once satisfied, click on Continue. The next step we will set the Calendar server host:

Atmail comes with a built-in server for CalDAV & CardDAV access, which allows many desktop calendaring and contacts applications to sync. By default, this server is running from within a subdirectory in the Atmail root.

Some clients however require that the server runs on the root of a domain. To enable this the following apache configuration is required: /etc/httpd/conf/httpd.conf file (or equivalent)

Listen 8008
<virtualhost *:8008="">
DocumentRoot /var/www/html/atmail/dav
RewriteEngine On
RewriteRule ^/(.*)$ /rootserver.php [L]
Click continue when completed.

You will then see the following window:

Place your SMTP Hostname in the fields above. You can also choose to enable SMTP Authentication for mail servers that require it. Also enter the email address for the Atmail Admin. This is used as a reference on the WebMail interface for assistance

Click on Continue. You will be greeted by the Registration page:

You can generate a serial key for your DownloadID by clicking on the link labeled “Serial Key”. This will create a key that is sent to your email address.

Once you are finished, click on “Continue” for the last step.

Input your preferred WebAdmin login details, and proceed.

Congratulations! You have installed the Atmail 7!


A .htaccess file was created in /var/www/html/atmail/install/. To prevent malicous removal of this file, please ensure it is owned by root and has correct permissions:

find /var/www/html/atmail/ -name .htaccess -exec chown root:root {} \;
find /var/www/html/atmail/ -name .htaccess -exec chmod 644 {} \;

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

Post-Installation Notes

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.

Atmail Spellchecker

Atmail has the option to install a server side spell checker. To enable the Atmail server side spell checker, do the following.

Install php-pspell

yum install php-pspell

Install aspell


Download dictionary from

wget ""
Extract Package
tar vxfj aspell6-en-7.1-0.tar.bz2
Install Package
cd aspell6-en-7.1-0
./configure && make && make install
Confirm Installation

Check the dictionary is successfully installed.

aspell dump dicts

If there is no output, the dictionary has not been installed successfully.

Example Output
[root@localhost ~]# aspell dump dicts
Enable Atmail Spellchecker

Go to WebAdmin > Settings > WebMail Settings > Enable Spell Check.

Re-Installation Notes

If you wish to start WebMail installation again, after you have already installed WebMail software you will need to remove the following files from your server.

Go to WebMail directory within your Atmail installation folder and run the following commands.

rm /var/www/html/atmail/.installed

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

Once you have done this go to browser and browse to You will be greeted with the install for Atmail WebMail client.



Contact our support team

+61 (7) 5357 6605