Cheap VPS & Xen Server

Residential Proxy Network - Hourly & Monthly Packages

Changing From SquirrelMail To Atmail Open With ISPConfig 3


Atmail Open is an open source webmail client which is available free of charge and is a great alternative to Squirrelmail. This tutorial shows how to use it with ISPConfig 3 (instead of SquirrelMail). More information available here… http://atmail.org

Step 1 – Create A Database

First we need to create a database for Atmail.

  • Open up ISPConfig and go to Sites.
  • Select Database from the sub-navigation menu on the left.
  • Click on Add new Database
  • Create a Database name, Database user and a Database password

 

Step 2 – Backup Squirrelmail

Just in case it all goes wrong – we need to backup Squirrelmail.

cd /usr/share
mv squirrelmail squirrelmail.bak
mkdir squirrelmail

 

Step 3 -Download, Unpack And Remove Unnecessary Files

I was unable to get the latest version of Atmail open to work with my setup. For the purpose of this tutorial; we will be using v1.01 – Please feel free to let me know if you find a way to get the latest version working.

cd squirrelmail
wget http://downloads.sourceforge.net/atmailopen/atmailopen-1.01.tgz
tar xvfz atmailopen-1.01.tgz
cd atmailopen
mv * ../
cd ../
rm –r atmailopen
rm atmailopen-1.01.tgz

 

Step 4 – Make Atmail Open Writeable For Apache

chown –R [Apache-user] /usr/share/squirrelmail

Please note: On Debian systems, replace [Apache-user] with www-data. The Apache user on other Linux distributions might be different.

 

Step 5 – Install Atmail Open To Your Server

In your preferred browser, go to http://yourdomain.tld/webmail. You’ll be required to read the on-screen instructions and read the licence agreement. Providing you accept you can continue!

 

Step 6 – Connect To The Database

In Step 1 we created a database in ISPConfig and we’re now need to enter the details into the AtMail Open…

pic2

Step 7 – Define The SMTP Host

Enter the SMTP Host (in this example we assume it is localhost). Whether or not you require Authentication (e.g. if you need to use a mail relayer to send e-mail) and an Administrator E-mail Address.

pic3

Step 8 – Import Data From SquirrelMail (Or Another Webmail System)

At this step, you have the possibility to import data from other popular webmail systems. Should you decide to do this, please select Squirremail and enter the database connetion settings and click ‘Continue’

pic4

Step 9 – All done! Log In To Atmail Open

You can now log in to your new Atmail Open Webmail system! It’s all good to go from here but if you like, follow Step 10 to customise your login screen.

pic5

Step 10 – Customise The Login Screen

In this step we will cover how to remove the Mailserver, Language and Protocol fields from the login screen and define default settings so we don’t need to input them manually everytime we login.

vi /usr/share/squirrelmail/html/login-light.html

Find the lines below and edit accordingly…

Login Header / Title text

< td >Webmail Access< /td >

Instructions to login / Custom Message

< td >< div id="AuthStatus" class="logintext" style="padding-left: 4px;" >Please provide your username and password.< /div >< /td >

Hide ‘Mailserver; field from login page and set default to ‘localhost’

Find…

< tr id="mailserver" >

And change to…

< tr id="mailserver" style="display:none;" >

Find…

< td align="left" >< input name="MailServer" type="text" class="logininput" id="MailServer">< /td >

And change to…

< td align="left" >< input name="MailServer" type="text" class="logininput" id="MailServer" value="localhost" >< /td >

Hide protocol from login page

Find…

< tr id="protocol" >

And change to…

< tr id="protocol" style="display:none;" >

Hide Language from login page

Find…

< tr >
     < td > < /td >
     < td colspan="2" align="right" >Language:< /td >

And change the < tr > tag to…

< tr style="display:none;" >

Please let me know if you have any suggestions to improve this tutorial… Enjoy!

 

Comments

comments