Difference between revisions of "Talk:Ilohamail for Linux"

Latest revision as of 15:05, 12 February 2014

IlohaMail On Your ISPConfig Server Within 10 Easy Steps

Step 1 - Create a website In ISPConfig, create a website via “New site” in the main menu. On the tab called “Basis” use webmail for the hostname and myhostingcompany.tld for the domain name. Enable MySQL and PHP scripts for this website but disable PHP Safe Mode.

Step 2 – Create a Administator user for the website In ISPConfig, create a Administrator user, so you can upload the website later via FTP: In the main menu select “ISP Manager”, select your new website called webmail.myhostingcompany.tld in the structure tree and press the tab “User and Email”. Press “new” and define a new user and its email address. Give this user administrator rights and press “Save”.

Step 3 - Create a MySQL database for the website: Click on the tab called “Options” and create a new database for the website. ISPConfig will show you:

Database name: web1_db1 (example) Database user: web1_u1 (example)

Then you define a password for the Database user and press “Save”.

Step 4 – Download IlohaMail You can download IlohaMail from URL http://ilohamail.org/main.php?page=Downloads to your own desktop computer.

At the moment there are two versions available: IlohaMail-0.8.14-rc3, which is the current and stable version. IlohaMail-0.9, which is the development version. Although version 0.9 has the most features, I do recommend the 0.8.14-rc3 version for a production environment.

After downloading IlohaMail, extract it to the filefolder of your choice.

Step 5 – Configure IlohaMail for our ISPConfig server Note: you can make a lot of settings, I will only mention the ones who are important for a basic setup. Browse to your extracted IlohaMail file folder. In that folder, open the conf folder.

Modifications to make in file conf/login.php:

In this file, you will find a line with: $default_host = ""; Change this into the full hostname of your server, like: $default_host = "server1.myhostingcompany.tld";

The default port for IlohaMail is IMAP over port 143. If you want to use pop3 instead of IMAP change the line: $default_port = 143; into: $default_port = 110;

We also hide some options of the login screen:

$hide_host = 1; $hide_protocol = 1; $hide_rootdir = 1; $hide_lang = 1;

Note: value 1 = hide, value 0 = show

The line: $logout_url = "index.php"; tells us where to go, when a user logs out. You can here define the file/URL of your choice.

You can also change the line $VDOMAIN_DETECT["domain1.com"] = "mail.domain1.com"; Into $VDOMAIN_DETECT["domain1.com"] = "server1.myhostingcompany.tld";

And the line $VDOMAIN_DETECT["domain2.net"] = "mail.domain2.net"; into: $VDOMAIN_DETECT["domain2.net"] = "server1.myhostingcompany.tld";

Modifications to make in file /conf/conf.php:

As we want to use IlohaMail with all the functions, using the MySQL database, we have to change the line: $backend = "FS"; into $backend = "MySQL";

To enable the calendar function and bookmarks use value = 0 To disable the calendar function and bookmarks use value = 1

$DISABLE_CALENDAR = 0; $DISABLE_BOOKMARKS = 0;

You can tell your mailusers where to report SPAM by changing the line: $report_spam_to=""; into $report_spam_to="username@myhostingcompany.tld";

(Define an existing email address on your domain, where users can report spam).

Define your SMTP server. At this point you can choose between “Courier”and “Sendmail”. If you use Postfix, leave the line $SMTP_TYPE = "sendmail"; just as it is!

Modifications to make in file conf/db_conf.php

Change the lines:

$DB_HOST=""; $DB_USER=""; $DB_PASSWORD="";

into:

$DB_HOST="localhost"; $DB_USER="web1_u1"; $DB_PASSWORD="mypassword";

(The password as defined at STEP 3).

STEP 6 – mySQL database In the mySQL directory in the IlohaMail filefolder, you will find a file called sql. You can use this file to create the tables of the mySQL database. In this example, I do this with phpMyAdmin. You can access your database via your Internet browser via URL http://webmail.yourhostingcompany.tld:81/phpmyadmin/

If you do not have phpMyAdmin installed, you can download it at http://www.ispconfig.org/downloads.htm

Login into phpMyAdmin with the mySQL user account as mentioned/defined at STEP 3.

In phpMyAdmin: - select your database - select the SQL icon to start a query - choose your sql file In the mySQL directory in the IlohaMail filefolder and press “Start” - You can exit phpMyAdmin

STEP 7 – uploading IlohaMail Now, you can upload IlohaMail, using your favourite FTP-client. URL: ftp://webmail.myhostingcompany/web username and password as defined at STEP 2.

STEP 8 – making the DATA directory read/writeable for Apache Login to you server as root. Perform the commands:

cd /var/www/web1/web (web1 is just an example and must be the same web number as mentioned at STEP 3).

dir (Now you will see the data directory).

Give web server process read/write privileges to all folders in the data directory:

chown -R www-data:www-data data (This is how it workes on Debian Linux, other distros might differ).

STEP 9 – access your new webmailclient Now you can point to your new webmail client with your favourite browser. The address according my how to is: http://webmail.myhostingcompany.tld

You can login with any valid e-mailaccount (username/password) combination. Note: do not use alias@domain.tld as in the Uebimiau package provided by ISPConfig. Only use the username and password.

After your first login you should make some settings before you start using IlohaMail. Here, the first thing you have to do is define your identity. You can define more than one identity for an email address but you need at least one.

STEP 10 – customizing IlohaMail You can change the default colours of IlohaMail. To change the colours, the only thing you have to do is open the file /var/www/web1/web/source/themes/default/override.inc and change the colours you want by changing the values. (Web1 is just my example).

More information about IlohaMail: http://ilohamail.org/main.php