This is a guide for installing the free Atmail web client in an Ubuntu environment.

Open your favourite web-browser and navigate to www.atmail.org/download.php to get a copy of the Atmail Open tarball.

Run the following command to become root:

# sudo /bin/bash

If apache, PHP and MySQL are not already installed, run the following commands:

# apt-get update
# apt-get install apache2 php5 libapache2-mod-php5 mysql-server mysql-client php5-mysql libapache2-mod-auth-mysql

Move the Atmail Open tarball into your webservers root public directory.

# mv ./atmailopen.tgz /var/www/

Extract the tarball with the following commands:

# cd /var/www
# tar xzvf ./atmailopen.tgz

Now navigate to http://localhost/atmailopen in your favourite web browser and there should be a page there, most likely displaying an Installation Error, do not panic! This is absolutely normal.Go back to the command line and run the following command,

# chown -R www-data /var/www/atmailopen

(where www-data is the user running apache)You will also need to turn magic quotes off in your php.ini file (most likely at /etc/php5/apache2/php.ini)

Find the line that says:

magic_quotes_gpc = On

and change it to:

magic_quotes_gpc = Off

Save and quit the text editor that you used, then restart apache with the following command:

# /etc/init.d/apache2 restart

Now navigate to http://localhost/atmailopen in your favourite web browser and make sure there is no errors in the @mail Pre-installation check, then click "continue" at the bottom of the page.

Select the default language that you wish to use in your Atmail installation, read the license agreement, and if you agree to them, select "Yes I agree to the above license", and click "Continue >>".

You have now reached Step 2 of the Atmail client installation.

Enter your MySQL details in the form presented to you:

SQL Server Type = MySQL
SQL Server Hostname or IP = localhost
SQL Username = root
SQL Password = whatever you set it to when you installed MySQL
Database Name = atmail
Create Database = Checked
Create Database Tables = Checked

Select "Continue >>"

You have now reached Step 3 of the Atmail client installation.
Enter your SMTP and Admin Email information:
You can use an external SMTP server or install an SMTP server on localhost, as long as the value in this field is changed to suit.

In this case, I have installed exim on the host machine, this can be achieved with the following command:

# sudo apt-get install exim4

Click "Continue >>"The next page will ask you about migrating from another webmail system, if you wish to migrate from Horde, Roundcube, or Squirrelmail, Atmail supports this, and you should select the appropriate webmail system to migrate from, however I will not be migrating from any previous webmail system in this tutorial, so I will just select "Continue >>" which concludes the Atmail client installation.

The final page of your installation should look like the following:

Congratulations, you have successfully installed your new webmail client, select "Login to Webmail" to start using it!

When using Windows and a email-address/mailto link is clicked in Internet-explorer ( or another other application ) , Outlook is automatically used to compose an email message.By modifying the registry this can be replaced with Atmail. When an email-link is clicked, the compose page of Atmail is displayed.The user must first be logged into Atmail, otherwise the login prompt will be displayed.To enable run regedit and modify the following key:HKEY_CLASSES_ROOT\mailto\shell\open\commandReplace with:

C:PROGRA~1Internet ExplorerIexplore.exe “http://yourdomain/parse.php?file=html/english/xul/compose.html&XUL=1&func=new”Replace http://yourdomain.com/mail/ with the URL of Atmail on your server.

"A DNS Blacklist, or DNSBL, is a means by which an Internet site may publish a list of IP addresses that some people may want to avoid and in a format which can be easily queried by computer programs and the Internet. The technology is built on top of the Internet Domain Name System, or DNS. DNSBLs are chiefly used to publish lists of addresses linked to spamming. Most mail server software can be configured to reject or flag messages which have been sent from a site listed on one or more such lists." - http://en.wikipedia.org/wiki/DNSBL

To install apache DNSBL you must first have Apache 2.2 with the mod_access.so module installed.

The module that this document will walk you through installing is called mod_access_dnsbl and it's homepage can be found here, in particular, the file that you will need is here.
It is a requirement of mod_access_dnsbl that the mod_dnsbl_lookup module be installed first, which can be found here.
These files can be downloaded with the following commands:

# wget http://www.apacheconsultancy.com/modules/mod_access_dnsbl/mod_access_dnsbl-0.01.tar.gz
# wget http://www.sysdesign.ca/archive/mod_dnsbl_lookup-0.91.tar.gz

It is recommended that you move these files into a sub-directory of /tmp, this can be achieved with the following commands

# mkdir /tmp/apachednsblinstall
# mv ./mod_access_dnsbl-0.01.tar.gz /tmp/apachednsblinstall/
# mv ./mod_dnsbl_lookup-0.91.tar.gz /tmp/apachednsblinstall/
# cd /tmp/apachednsblinstall

Now you must extract the files with the following commands

# tar xzvf mod_access_dnsbl-0.01.tar.gz
# tar xzvf mod_dnsbl_lookup-0.91.tar.gz

Move into the newly created mod_dnsbl_lookup directory:

# cd mod_dnsbl_lookup-0.91

Compile and install the module

# ./autogen.sh
# ./configure
# make
# make install

(for configuration options of this module, refer to /tmp/apachednsblinstall/mod_dnsbl_lookup-0.91/README)

Proceed to the mod_access_dnsbl directory with the following command:

# cd ../mod_access_dnsbl-0.01

Install the mod_access_dnsbl module with the following command (NOTE: You will need to have the apxs tool installed: http://httpd.apache.org/docs/2.2/programs/apxs.html)

# apxs -cia mod_access_dnsbl.c

(for configuration options of this module, refer to /tmp/apachednsblinstall/mod_access_dnsbl-0.01/README)

Ensure that the necessary lines in your httpd.conf file have been updated to load the extra modules, they should look something like this:

LoadModule dnsbl_lookup_module  modules/mod_dnsbl_lookup.so
LoadModule access_dnsbl_module  modules/mod_access_dnsbl.so

Restart Apache 2.x

# /etc/init.d/apachectl restart

Your new Apache DNSBL should now be up and running!

You can limit AtMail to only access the local Mailserver by doing the following:

- go to WebAdmin > Config > Mail Configuration

- set the MailServer field to "127.0.0.1"

- save changes

- download the file from: http://atmail.com/kb/attach/mailserver-update.txt

- place it on your server as: /usr/local/atmail/webmail/modules/mailserver-update.php

- execute the file:

% cd /usr/local/atmail/webmail/modules/ && php mailserver-update.php

- this will update every local user's MailServer definition to " 127.0.0.1 "

- you can further limit access by setting WebAdmin > Config > Mail Configuration > Mail Type to "No External Servers"

- save changes, restart Apache.