Debian Roundcube

Roundcube Allgemeines

Roundcube ist ein moderner Webmail-Client, der auf PHP basiert. Durch die Verwendung von Ajax gleicht er in der Bedienung eines Desktop Mailprogramms. Mittels Ajax ist es möglich, dass neue Mails einfach im Posteingang erscheinen, ohne einen Refresh durchzuführen, oder Mails mit der Maus durch Drag&Drop zu verschieben. Kehrseite der Medaille: Er verbraucht etwas mehr Resourcen und hat längere Ladezeiten als etwa Squirrelmail.

Informationen rund um Roundcube gibts auf der Projektseite: http://roundcube.net.

Installation

Voraussetzung:

• → Webserver und PHP sind eingerichtet und funktional.
• → MySQL
• Imap Mailserver wie z.B. → Postfix+Cyrus Imapd ist eingerichtet.

Roundcube steht leider nicht per apt-get download zur Verfügung und muß daher manuell downgeloaded und installiert werden.

Download

Download von Roundcube von der Webseite: http://roundcube.net/downloads.

Hinweis:
Im folgenden wird davon ausgegangen, dass die Version "roundcubemail-0.8.1.tar.gz" verwendet wird. Falls eine Version mit anderem Namen verwendet wird, evtl. unten Pfad anpassen.

cd /usr/local/src
wget http://sourceforge.net/projects/roundcubemail/files/roundcubemail/0.8.1/roundcubemail-0.8.1.tar.gz

Entpacken und ins Webserver-Verzeichnis verschieben

tar vxf roundcubemail-0.8.1.tar.gz
mv roundcubemail-0.8.1 /var/www/roundcube

Datenbank für Roundcube anlegen und Rechte erteilen:

Folgenden Befehl eingeben, um in der MySQL Adminschnittstelle zu landen:

mysql -u root -p

Passwort sql_root_pwd eingeben, wenn danach gefragt wird Darin folgende Befehle eingeben:

Achtung:
auf exakte Schreibweise achten; roundcube_pwd mit dem Passwort, des eben angelegten Users roundcube,ersetzen

CREATE DATABASE roundcubemail;
GRANT ALL PRIVILEGES ON roundcubemail.* TO roundcube@localhost IDENTIFIED BY 'roundcube_pwd';
FLUSH PRIVILEGES;
exit

Datenbank Schema importieren:

mysql -u root -p roundcubemail </var/www/roundcube/SQL/mysql.initial.sql

Konfiguration

Die Konfiguration erfolgt in mehreren Stufen, bis Roundcube korrekt funktionert.

Apache/PHP Konfiguration

Debian Squeeze verwendet standardmäig die PHP Erweiterung Suhosin mit der Einstellung suhosin.session.encrypt=on. Diese ist leider nicht mit Roundcube kompatibel und muss deaktiviert werden:

vi /etc/php5/apache2/conf.d/suhosin.ini

Folgende Zeile

;suhosin.session.encrypt = on

abänderun in:

suhosin.session.encrypt = off

Zeitzone setzen:

vi /etc/php5/apache2/php.ini

Folgende Änderung durchführen (Kommentarzeichen ; entfernen)

date.timezone = Europe/Berlin

Apache neu starten:

/etc/init.d/apache2 restart

Roundcube-Konfiguration online erstellen

Webbrowser öffnen und http://IP_des_Servers/roundcube/installer eingeben

Roundcube Webmail Installer erscheint. Die Konfiguration der Installation wird geprüft und die Ergebnisse übersichtlich angezeigt.

Button NEXT anklicken.

In der folgenden Seite folgende Konfigurationseinstellungen vornehmen: General configuration:

product_name:      RoundCube Webmail (kann auch beliebig abgeändert werden)
temp_dir:          Default Einstellung belassen
ip_check:          Default Einstellung belassen
des_key:           Default Einstellung belassen
enable_caching:    ja
enable_spellcheck: Bei Bedarf (Rechtschreibprüfung braucht Resourcen)
identities_level:  Default Einstellung belassen

Logging & Debugging:

debug_level:       Log errors
log_driver:        Syslog
log_dir:           Default Einstellung belassen
syslog_id:         Default Einstellung belassen
syslog_facility:   mail subsystem

Database setup:

Database Type:     MySQL
Database server:   localhost
Database name:     roundcubemail
Database user:     roundcube
Database password: roundcube_pwd

IMAP Settings:

default_host:      localhost
default_port:      143
username_domain:   leer lassen, da für Postfix/Cyrus nicht nötig
auto_create_user:  ja
sent_mbox:         Sent
trash_mbox:        Trash
drafts_mbox:       Drafts
junk_mbox:         Junk

SMTP Settings:

smtp_server:       localhost oder SMTP des Providers (siehe Test des Mailserver)
smtp_port:         25
smtp_user/smtp_pass: leer bei SMTP-Server=localhost, ansonsten Angaben des Providers
Use the current IMAP Username for auth. : nein
smtp_log:          ja

Display settings & user prefs

Language:          de
Skin:              default
pagesize:          40
prefer_html:       ja
preview_pane:      ja
htmleditor:        ja
draft_autosave:    5min
mdn_requests:      ask the user
mime_param_folding:Full RFC2231

Button CREATE CONFIG anklicken

Der Inhalt für die beiden Konfigurationsdatein main.inc.php und db.inc.php wird angezeigt. Dieser wird per Copy&Paste in die Konfigurationsdateien übertragen. Dies funktioniert nur mit Putty. Ansonsten den Inhalt auf dem PC in eine Datei mit dem jeweiligen Dateinamen abspeichern und per FTP oder Windowsfreigabe.

Achtung:
Den Button CONTINUE noch NICHT anklicken. Erst wenn in dieser Anleitung dazu aufgefordert wird.

Verfahren mit Putty:

vi /var/www/roundcube/config/main.inc.php

Auf der Webseite dargestellter Inhalt für die Datei main.inc.php kopieren und in die Datei einfügen (mit rechter Mausklick).

vi /var/www/roundcube/config/db.inc.php

Auf der Webseite dargestellter Inhalt für die Datei db.inc.php kopieren und in die Datei einfügen (mit rechter Mausklick).

Alternativ: Verfahren mit Transfer vom PC auf den Server:

• Editor auf dem PC öffnen.
• Dargestellter Inhalt für main.inc.php kopieren, im Editor Einfügen und Datei lokal unter main.inc.php abspeichern
• Dargestellter Inhalt für db.inc.php kopieren, im Editor Einfügen und Datei lokal unter db.inc.php abspeichern
• Editor schließen
• Die beiden Datein main.inc.php und db.inc.php mit FTP oder Windows Netzwerkumgebung auf den Server kopieren - z.B. in Verzeichnis /public (Falls die Files in ein anderes Verzeichnis kopiert wurden, den Pfad im Folgenden entsprechend anpassen).

cp /public/main.inc.db /var/www/roundcube/config
cp /public/db.inc.db /var/www/roundcube/config

• WICHTIG: Sofort nach dem Übertragen, beide Dateien löschen, da diese Passwörter für die Roundcube Datenbank enthalten

rm /public/main.inc.db
rm /public/db.inc.db

Button Continue anklicken

Die Konfigfiles und Rechte werden geprüft und das Ergebnis angezeigt.

Button Initialize Database anklicken, um die Datenbank zu initialisieren.

Installer: Test SMTP settings Sender- und Recipient-Emailadressen eingeben und auf Button Send test mail klicken. Nach einigen Sekunden, solte sich eine Testmail im Postfach des Empfängers (Recipient) befinden.

Installer: Test IMAP configuration:

Am unteren Ende der Webseite besteht die Möglichkeit, einen Imap Login-Test durchzuführen, um zu sehen ob die Konfiguration in Ordnung ist.

Username und Passwort eines gültigen, angelegten Mailusers eintragen. Button CHECK LOGIN betätigen.

Folgende Ausgabe solte erscheinen:

Connecting to localhost...
IMAP connect:  OK(SORT capability: yes)

Zugriffsrechte der Konfigfiles

chmod 600 /var/www/roundcube/config/main.inc.cfg
chmod 600 /var/www/roundcube/config/db.inc.cfg
chown -R www-data:www-data /var/www/roundcube/config/ 

Test von Roundcube:

Webbrowser öffnen und http://IP_des_Servers/roundcube eingeben.

Der Login-Bildschirm sollte nach gewisser Ladezeit erscheinen. Mit einem gültigen Mail-Account einloggen und abwarten, bis die Hauptansicht von Roundcube erscheint.

Wenn dies der Fall ist, ist Roundcube korrekt eingerichtet.

Abschluss der Installation

Aus Sicherheitsgründen sollte der Installer entfernt werden, nachdem Roundcube den Funktionstest bestanden hat. Dieser ist nun nicht mehr nötig, da evtl. Konfigurationsänderungen direkt an den beiden Konfigdateien mit einem Editor wie vi durchgeführt werden sollten.

rm -R /var/www/roundcube/installer

Persönliche Einstellungen in Roundcube vornehmen

Roundcube bietet auf der Webseite jedem Nutzer die Möglichkeit, persönliche Einstellungen vorzunehmen. So kann z.B. die Sprache, die Ansichten, usw. geändert werden. Auf jedenfall sollte die Identität geprüft/geändert werden, die die Mailadresse für ausgehende Mails definiert.