Atmail 6 WebMail Client Installation
-------------------------------------

This document will explain how to install your Atmail WebMail Client software
utilizing it's 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.

Before you install Atmail please make sure you meet the minimum requirements. 

http://atmail.com/wiki/doku.php?id=installation:requirement

Download and extract Atmail WebMail Client 
-------------------------------------------

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

SSH web server access
=====================

Download the Atmail archive and extract it.

	tar zvxf atmail6webmail.tgz -C /var/www/html/

Atmail 6 WebMail Client need 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
  * SUSE based distributions : /srv/www/htdocs
  * Debian based distributions : /var/www/apache2-default

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 /var/www/html/atmail/

FTP web server access 
=====================

Extract the Atmail 6 archive onto your local machine, then FTP the entire
atmail directory to your server's DocumentRoot or VirtualHost directory.

Installing Atmail 6  
-------------------

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

When accessing this page you should see a the Atmail Pre-Installation Check.

Verify that all the required modules are installed. 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
Step 1 of the installation.

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

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 screen will then prompt you for
CalDav information.

You can either skip this step, or install the Calendar Server using the
instructions outlined at: 

http://atmail.com/wiki/doku.php?id=atmail6:calserver 

Choose your preferred method, then click "Continue".

You will then see SMTP and Admin Email Configuration. 

Place your SMTP Hostname in the fields above. You can also choose to enable
SMTP Authentication for mail servers that require it. Another option is the
PUSH feature, that allows your users to receive PUSH emails via their
ActiveSync-enabled devices.

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 6!