On this page... (hide)
The source-installation can be used to setup the complete Mailserver/WebMail mode of Atmail 6. This document will illustrate how to configure the Atmail 6 software from source. If you only want to setup the WebMail client, please refer to the Atmail 6 WebMail Client Installation Guide.
Before you install Atmail please make sure you meet the minimum Atmail System Requirements.
It is recommended that you use the server-install.php script to configure your Atmail 6 system.
If you are using FreeBSD 7.x as your host system please refer to the FreeBSD 7.x Installation Notes section.
The purpose of this script is to configure the Atmail 6 application for the server, and to save the runtime settings to the main Configuration.
You run the installation script by running the following commands:
% tar xvfz atmail6mailserver.tgz -C /usr/local/ % cd /usr/local/atmail/ % php server-install.php
Atmail 6 must be installed under the default pathname of /usr/local/atmail/ - The atmail6mailserver.tgz archive has the directory structure pre-setup. Using the tar command extract the archive into the /usr/local directory.
If hard-disk space is an issue of the selected partition, the Atmail 6 directory can be moved to another volume so long as the /usr/local/atmail directory is symbolically linked to the new directory.
Below is a walk through of the command-line installation script server-install.php:
Note that the following packages and modules need to be installed prior to installing AtMail:
PHP (PHP 5.1.6+ required) - PHP is required and is usually installed by default with most Linux Distributions and Unix Variants. Note that you will also need to have the following packages installed:
Minimum PHP version required is 5.1.6
* iconv * hash * pdo * pdo_mysql * pcre * SPL * standard * Reflection * mbstring * session * ctype
* ldap - for ldap queries * openssl - for IMAPs * imap - for PUSH and Sync support for iPhone, Windows Mobile and ActiveSync devices * gdinfo - For abook photo upload, resize and image reflection
* Safe mode, recommended OFF - Atmail requires safe-mode off by default * Register globals, recommended OFF - This feature is recommended to be turned off for security * Magic quotes, recommended OFF - The magic_quotes_gpc setting must be turned off in the php.ini * File uploads, recommended ON - Required for attaching files to emails * Max Filesize Upload, recommended 16M or higher. Increase for larger attachment support * Maximum Size of POST data, recommended 16M or higher - Recommended max post size for attachments
The installer will check your system has the required PHP runtime settings.
You can install the optional PHP extensions via your system package manager or
via the PHP pecl system. The installer will also scan your php.ini
configuration file and make the required adjustments for Atmail.
Currently the installer is in BETA stage for FreeBSD support. In the future, you will not have to manually satisfy the package dependencies or ensure sendmail is not started. Our target is to have a equivalent installation experience such as debian.
Using your favorite method of package installation (http://www.freebsd.org/doc/en/articles/linux-users/article.html#SOFTWARE, http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html), ensure the FreeBSD equivalent following debian packages are installed:
* php5, php5-mysql, php5-xmlrpc, php5-openssl, php5-gd, php5-ctype, php5-mbstring, php5-dom, apache, mysql, libmysqlclient-devel, zlib, zlib-devel, gcc * gcc-c++, gcc-locale, make, libdb-4_5, libdb-4_5-devel, libgda, openssl, libopenssl-devel, expect, libstdc++-devel, autoconf, automake * bison, flex, gdb, subversion, sqlite3, sqlite3-devel, patch, attr, findutils-locate, apache2-mod_php5
Using vi or your favorite editor, ensure that sendmail is not started in your boot scripts by checking that inside the file:
/etc/rc.conf
The following line must exist:
sendmail_enable="NO"Next, ensure that mysql is started in your boot scripts inside the same file:
/etc/rc.conf
The following line must exist:
mysql_enable="YES"The following few prompts will set up your MySQL Database for Atmail. You will need to supply a MySQL user that has permission to create databases.
Using Atmail 6 you can scale the software solution by storing user email/account information on a separate machine from the webserver.
It is recommended to use Atmail 6 and MySQL on the same machine for userbases under < 10,000 accounts.
If the MySQL server is setup on the same machine leave the 'Hostname' field blank. This will make Atmail 6 communicate with the database server directly rather than opening a TCP/IP connection.
After this step you will have the option of creating the tables for the Atmail 6 database, and test the MySQL configuration details are correct.
Then, continue:
Atmail includes a WebAdmin control-panel for administration of the Atmail system, including system management, users, and more.
Please specify the admin email-address and password to Webadmin access.
Atmail 6 WebAdmin Details}}
Please specify the domain names for which you wish to configure for Atmail. At least one domain name must be specified to complete the installation. Enter domain names for which you wish to host email accounts. Separate multiple domains by a comma.
In the next step of configuration, the installation utility will compile the SMTP server ( Exim ), POP3/IMAP server, and optionally CalDAV, Spamassassin AV scanner from source.
Before installing these modules your system must have the gcc compiler installed with the relevant system libraries/headers ( gcc is installed as standard under common Unix platforms ).
The mySQL header and library files are also required to be installed before installation. These library files should be installed by default with mysql, otherwise you can obtain the header/library files from the Mysql.com site ( Download the RPM or binary for your selected system, otherwise build the mySQL server from source).
Once complete you should see the following.
Once complete you should see the following.
Optionally install the Atmail Calendar server (CalDAV)
This module provides a complete Calendar server for the Webmail interface and third-party clients via the CalDAV protocol.
Note that if you choose not to install the Atmail Calendar server you will not have a calendar within your WebMail. If you choose to skip this option and change your mind and wish to install the calendar server please refer to Atmail Calendar Server Installation.
Your file system requires extended attribute support to run the calendar server. The flag USER_XATTR needs to be set. With some distributions, this is not set by default and you can either allow the installation utility to create a device for you or you can manually modify your fstab file to include extended attribute support. Be very careful when modifying your system fstab file as it can result in a system that refuses to boot! If in doubt, allow the installer to create a compatible mount point for you.
Once complete you should see the following.
Optionally, the Spamassassin mail-filter can be installed to protect user accounts from Spam messages. Inbound messages are checked against a variety of rulesets and checksums to validate if a message is Spam.
Optionally, the Atmail-Clam AntiVirus engine can be installed to protect user accounts from virus infection.
Your server is now installed with Atmail
To access the Atmail login interface, visit:
Replace localhost with your webserver hostname.
For more information configuration of Atmail software see:
Atmail uses the SysV startup scheme, the atmailserver startup script will be located:
% /etc/init.d/atmailserver
You can start, restart and stop the services for Atmail, by using these commands after the script, for example:
% /etc/init.d/atmailserver start % /etc/init.d/atmailserver restart % /etc/init.d/atmailserver stop
To uninstall the calendar server please ensure all calendar services have been stopped. You can do this by issuing the command.
/etc/init.d/atmailserver stop
To ensure the calendar server has stopped you can check with:
ps aux | grep python
There should be no 'twisted' processes running. You may now simply remove the final calendar installation directory.
rm -rd /usr/local/atmail/calendarserver