Creating smarthosts with Exim is easy, but you may want to enable SMTP authentication during transactions for additional security. Just go through the following steps:

1.) Open up your /usr/local/atmail/mailserver/configure file, and find:

dnslookup:
driver = dnslookup
domains = ! +local_domains
transport = remote_smtp
ignore_target_hosts = 0.0.0.0 : 127.0.0.0/8
no_more

2.) Comment out this line so it looks like:

#dnslookup:
# driver = dnslookup
# domains = ! +local_domains
# transport = remote_smtp
# ignore_target_hosts = 0.0.0.0 : 127.0.0.0/8
# no_more

3.) Add this line below:

divertnonlocal:
driver = manualroute
domains = ! +local_domains
transport = remote_smtp
route_list = * 192.168.0.6
ignore_target_hosts = 0.0.0.0 : 127.0.0.0/8
no_more

4.) Replace "192.168.0.6" with your SMTP relay host (your smarthost destination).

5.) Find this line afterwards:

remote_smtp:
driver = smtp

6.) Change it to:

remote_smtp:
driver = smtp
 hosts_require_auth = 192.168.0.6
hosts_try_auth = 192.168.0.6

7.) Change "192.168.0.6" to your smarthost server.

8.) At the bottom of the file, find this line:

begin authenticators

9.) Below this, add:

login:

driver = plaintext

public_name = LOGIN

 (more...)

	

Ok so you've tried Atmail Open and liked the experience but now want the full Atmail experience and have purchased the commercial version. Now you ask "how can I upgrade from Atmail Open to Atmail commercial and not loose all my users' data?" Well follow these simple steps and you'll quickly be on your way to running Atmail.

First of all you will need to make sure you are running the lastest version of Atmail Open so that you have the up to date version of the upgrade script. Then if you haven't already you will need to purchase and download the commercial version. You will then need to extract the files into place. Where you extract the files will depend on what version you purchased, server+client or client only.

If you have purchased the server+client version then extract the tgz into /usr/local, this will extract out the Atmail files under /usr/local/atmail.

If you have purchased the client only version then extract the files into your existing Atmail Open directory.

Once the files are extracted you need to run the upgrade2atmail.php script found in your Atmail Open directory, this script will make all necessary modifications to your Atmail Open database so it can be used by the commercial version:

# cd /path/to/atmailopen
# php upgrade2atmail.php

NB: This script can only be run from the command line and should only be run once you are ready to install Atmail commercial version.

Once the script has completed you should run the relevant installer for the version you purchased. If you purchased the client only version you may need to remove the .htaccess file from the install/ directory before you can run the web based installer.

Webmail client install instructions

Server version install instruction

Vital!: When you get to the database set up section be sure to select or enter the name of the database used by Atmail Open so that all your user info will be available

Migrating users (Server Version only)

If you are upgrading to the full Atmail server version then you will need to migrate your users and their email into the Atmail system. How to achieve this depends on the formats used by the old mail server. You will find info on migrating from many different mail systems here on the KB under the Migration category and also several migrate scripts can be found in your /usr/local/atmail/webmail/modules directory.

You may wish to add banners to the AtMail interface - for advertisement, or branding purposes. Here is an easy way to do so, that only involves replacing a few files for the interface.

1.) Download header-mod.tgz from: http://atmail.com/kb/attach/header-mod.tgz

2.) Backup your current webmail directory:

% cp -R /usr/local/atmail/webmail /usr/local/atmail/webmail.backup

3.) Unpack the file, then confirm permissions:

% tar xvfz header-mod.tgz -C /usr/local/atmail/webmail/
% chown -R [apache user] /usr/local/atmail/webmail/

Where [apache user] is the Apache user. If using the Server version, this will be "atmail".

4.) You can then alter the /usr/local/atmail/webmail/webmailheader.php file, to reflect your desired banner code. The default in the file is:

5.) You can then alter the img tag to reflect the location of your banner. The location is relative to /usr/local/atmail/webmail/ - so a setting of "imgs/banner.png" will be for: /usr/local/atmail/webmail/imgs/banner.png

6.) Save your settings. This will then display your modifications at the top of the user email window after login.

A sample page may look like:

Under a fresh installation of RedHat Fedora Core3 ( FC3 ) , a compile of the Clam/@Mail Anti-virus daemon can fail with the following:

gcc: /usr/lib/libidn.so: No such file or directory
make[2]: *** [libclamav.la] Error 1
make[2]: Leaving directory `/usr/local/atmail/webmail/libs/src/clamav/libclamav'
make[1]: *** [all-recursive] Error 1
make[1]: Leaving directory

root# ln -s /usr/lib/libidn.so.11.4.6 /usr/lib/libidn.so

The following is a guide to setting up Atmail server in an Ubuntu environment.

First you must become root and install dependencies:

# sudo /bin/bash
(enter sudo password and press enter)
# apt-get update
# apt-get install apache2 php5 libapache2-mod-php5 php5-cli mysql-server mysql-client

# mv atmailphp5server.tgz /usr/local/

# cd /usr/local

# tar xzvf atmailphp5server.tgz

# cd atmail
# chmod +x ./server-install.php
# php ./server-install.php

# php ./server-install.php

SpamAssassin Installation: SUCCESSFUL
Now use default settings to install the anti-virus engine from source,

@Mail AV Installation: SUCCESSFUL
Compile & Installation complete