Anleitung: Webmail-Client Roundcube installieren und konfigurieren

Heute soll es darum gehen, wie man den Webmail-Client Roundcube auf seinem Webspace/Webserver installieren kann. Doch bevor es losgeht, möchte ich noch zwei, drei Worte verlieren, wofür das ganze überhaupt gut ist und warum ich mich für Roundcube entschieden habe. Wer nur an der Installationsanleitung interessiert ist, überspringt den folgenden Absatz einfach und liest bitte bei der nächsten Zwischenüberschrift (“Die Grundvoraussetzungen”) weiter.

Warum sollte ich mir einen Webmail-Client auf meinem Server installieren? Ich kann die Frage nur für mich und meinen Fall beantworten. Ich habe mehrere E-Mail-Adressen. Eine bei Googlemail und mehrere für meine Webseiten und Blogs, die jeweils alles ähnlich auf @name-der-webseite.net enden.

Wenn ich nun meine Mails abrufen möchte, dann möchte ich nicht zwingend fünf verschiedene Webseiten aufrufen und drei Programme öffnen. Ich hätte gerne alles an einem Platz. Googlemail bietet zwar das Einbinden weiterer Mailkonten an, beschränkt sich dabei jedoch auf POP3. Da ich auf IMAP nicht verzichten möchte, da sonst die Mails bei Googlemail landen und nicht mehr auf meinem Smartphone ankommen, war das also keine Lösung.

Bisher nutzte ich für die Problematik “Thunderbird Portable” auf einem USB-Stick. So konnte ich von überall aus meine Mails abrufen und musste nur ein Programm starten. Doch ganz perfekt ist diese Lösung auch nicht, denn öfters vergisst man den USB-Stick oder hat nur Zugriff auf einen Rechner, dessen USB-Ports entweder gesperrt sind oder der sich in einem Netzwerk befindet, dessen Firewall die IMAP-Ports blockt. Dies Lösung? Ein webbasierter Mailclient. Mehr als ein funktionsfähiger Browser wird nicht benötigt und man kann von überall aus seine Mails mit demselben Client abrufen. Und genau das ist und bietet Roundcube, weshalb es nun nachfolgend eine kleine Installations- und Konfigurationsanleitung für Roundcube gibt.

Die Grundvoraussetzungen

Um Roundcube zu installieren wird prinzipiell nur ein Webserver mit PHP-Unterstützung und einer Datenbank benötigt. Ich habe hier auf meinem Server eine Kombination aus Apache und MySQL laufen. Prinzipiell geht aber auch eine PostgreSQL-Datenbank und ein anderer Webserver wie zum Beispiel Lighthttpd.

• Webserver mit PHP Version >= 5.2.1
  • (z.B. Apache, Lighttpd, Cherokee, Hiawatha)
• Datenbank(-server)
  • (z.B. MySQL oder PostgreSQL)

Pakete laden und Webserver einrichten

Zuerst benötigen wir einen Ordner für die Roundcube-Installation im Root-Verzeichnis des Webservers. Im Falle von Apache ist dies in der Standardkonfiguration /var/www. Danach wechseln wir in den neu angelegten Ordner und laden mittels wget die aktuelle Roundcube Version herunter.

mkdir /var/www/roundcube
cd /var/www/roundcube
wget http://downloads.sourceforge.net/project/roundcubemail/roundcubemail/0.9.5/roundcubemail-0.9.5.tar.gz

Zum Zeitpunkt dieses Tutorials ist 0.9.5 die aktuelle Version. Es kann natürlich sein, dass im Laufe der Zeit eine neue Version veröffentlich wird und ich den Artikel nicht sofort aktualisieren kann. Deshalb kann ein Blick auf die Downloadseite des Roundcube-Projekts nicht schaden, um zu überprüfen, welches die aktuelle Version ist. Nachdem der Download abgeschlossen ist, muss das Roundcube-Paket noch entpackt werden. Dies geht zum Beispiel mittels des tar-Befehls.

tar xvf roundcubemail-0.9.5.tar.gz
cd roundcubemail-0.9.5
mv {.,}* ..
cd ..
rmdir roundcubemail-0.9.5

Im nächsten Schritt muss eine Konfigurationsdatei erstellt werden, um einen virtuellen Host anzulegen. Dieser Schritt ist Apache spezifisch. Solltet ihr die Installation auf einem anderen Webserver als Apache durchführen, muss ggf. ein ähnlicher Prozess durchlaufen werden. Die Konfigurationsdatei habe ich für meinen Fall “webmail” genannt.

cd /etc/apache2/sites-available
nano webmail

Innerhalb des Nano-Texteditors schreiben wir nun folgenenden Text in die Datei.

<VirtualHost *:80>
  ServerAdmin webmaster@meine-domain.de
  DocumentRoot /var/www/roundcube
  ServerName webmail.meine-domain.de
  ErrorLog /var/log/apache2/webmail.meine-domain.de-error_log
  CustomLog /var/log/apache2/webmail.meine-domain.de-access_log common
</VirtualHost>

Danach speichern und schließen wir die Datei mittels Strg+X. Im nächsten Schritt muss die Konfiguration des V-Hosts aktiviert und vom Apache Server geladen werden.

a2ensite webmail
service apache2 reload

Datenbank anlegen und konfigurieren

Im nächsten Schritt müssen wir die Datenbank für Roundcube anlegen, einen Nutzer einrichten und diesen mit den passenden Rechten versehen.

mysql -u root -p

mysql> CREATE DATABASE IF NOT EXISTS roundcube;
mysql> GRANT ALL PRIVILEGES ON roundcube.* TO roundcube@localhost IDENTIFIED BY 'mein_passwort';
mysql> FLUSH PRIVILEGES;
mysql> quit

Die Phrase “mein_passwort” müsst ihr natürlich durch euer Passwort ersetzen, welches ihr für die Datenbank verwenden wollt. Ganz wichtig ist auch der “FLUSH PRIVILEGES”-Befehl, damit die Rechteänderungen auch sofort ziehen. Ist die Datenbank angelegt, muss ihr noch “Leben eingehaucht” werden. Wir laden also die nötigen Daten aus der .sql-Datei, die im Roundcube-Paket mitgeliefert wurde.

mysql -u roundcube -p"mein_passwort" roundcube < /var/www/roundcube/SQL/mysql.initial.sql

Bevor wir nun mit dem Webinstaller fortfahren können, müssen wir die Datenbankverbindung in der entsprechenden Konfigurationsdatei der Roundcube-Installation eingeben.

cd /var/www/roundcube/config
nano config.inc.php

Innerhalb der Datei muss nun die Beispiel-Zeile mit dem Connection-String durch unsere aktuellen Verbindungsdaten ersetzt werden.

//In folgender Zeile muss mysql durch mysqli, "pass" durch "mein_passwort"
//und roundcubemail durch "roundcube" ersetzt werden
$rcmail_config['db_dsnw'] = 'mysql://roundcube:pass@localhost/roundcubemail';

//Das fertige Ergebnis sollte dann so aussehen:
$rcmail_config['db_dsnw'] = 'mysqli://roundcube:mein_passwort@localhost/roundcube

Nun muss die Datei wieder mittels Strg+X gespeichert und geschlossen werden.

Webinstaller und Grundkonfiguration

Wir nähern uns dem Ende des Tutorials. Im nächsten Schritt müssen wir den Roundcubes Webinstaller aufrufen. Dies geht nach dem Anlegen unserer Virtual-Hosts über folgende Adresse:

http://webmail.meine-domain.de/installer

Folgt den Schritten im Webinstaller und schließt das Setup ab. Nach erfolgreichem Abschluss muss der Order des Installers noch entfernt werden, damit niemand mit böswilliger Absicht dadurch Schaden anrichten kann.

rm -rf /var/www/roundcube/installer

Im letzten Schritt kann/sollte nun noch Roundcubes Hauptkonfigurationsdatei angepasst werden.

cd /var/www/roundcube/config
nano config.inc.php

Innerhalb der Config können nun folgende Anpassungen vorgenommen werden.

//enable_installer von 'true' auf 'false' setzen
$config['enable_installer'] = false;

//TLS für die Mailserver aktivieren
//Wir gehen davon aus, dass die Mailserver auf
//mail.meine-domain.de lauten. meine-domain entspricht
//jeweils der Domain hinter dem @-Zeichen.
$config['default_host'] = 'tls://mail.%s';

//Zum Versand denselben Mailserver wie zum Abruf nutzen
$config['smtp_server'] = 'tls://%h';
$config['smtp_port'] = 587;
$config['smtp_user'] = '%u';
$config['smtp_pass'] = '%p';

//Titel des Webmail Services angeben
$config['product_name'] = 'Mein Webmail Client';

Nun mit Strg+X schließen und speichern. Und danach kann es losgehen.

Einloggen und Mails abrufen

Nachfolgend zeige ich noch einmal den Loginvorgang. Aufgerufen wird der Webmail-Client über http://webmail.meine-domain.net. Nun möchte ich die Mails meiner E-Mail-Adresse webmaster@code-bude.net per IMAP abrufen. Hierzu gebe ich als Login die E-Mail-Adresse ein und als Passwort mein normales Mail-Passwort.

Durch die Config-Einstellung ($config[‘default_host’] = ‘tls://mail.%s’;) wird als Mailserver nun http://mail.code-bude.net benutzt, da wie oben erläutert %s der Domain hinter dem @-Zeichen, also code-bude.net, entspricht. Durch diese dynamische Zuordnung kann ich

mich mit meinen verschiedenen Mail-Adressen (@code-bude.net, @derwirtschaftsinformatiker.de, etc.) einloggen, ohne jedes mal explizit den Mailserver angeben zu müssen.

Mit einem Klick auf “Anmelden” geht es los und die Mails können abgeholt, gelesen und geschrieben werden, wie man es von jedem anderen Webmail-Client gewohnt ist.