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. Roundcube befindet sich noch in einem relativ frühen Entwicklungsstatdium, was an der Versionsnummer abzulesen ist (zur Zeit: 0.2.1), funktioniert aber schon ganz hervorragend.

Installation

Voraussetzung:

• → Webserver und PHP sind eingerichtet und funktional.
• 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.2.1.tar.gz" verwendet wird. Falls eine Version mit anderem Namen verwendet wird, evtl. unten Pfad anpassen.

cd /usr/local/src
wget http://downloads.sourceforge.net/roundcubemail/roundcubemail-0.2.1.tar.gz

Entpacken und ins Webserver-Verzeichnis verschieben

tar vxf roundcubemail-0.2.1.tar.gz
mv roundcubemail-0.2.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';
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. Hier sieht man vermutlich noch den frühen Entwicklungsstand. Das Hauptaugenmerk wurde mehr auf die operationelle Funktionalität als auf komfortable Installation und Konfiguration gerichtet. Dadurch "klemmt" es noch an der einen oder anderen Stelle bei der Onlinekonfiguration, die dann "per Hand" ausgebessert werden müssen. Dies ist aber alles halb so schlimm wie es sich zunächst anhört.

Roundcube-Konfiguration online erstellen

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

Roundcube Webmail Installer (Startseite) erscheint.

Auf Button START INSTALLATION klicken.

Konfiguration der Installation (PHP, SQL und Erweiterungen) wird geprüft und angezeigt. Evtl nicht vorh. Erweiterungen könenn ignoriert werden.

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).

→ hier gehts weiter.

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).
• WICHTIG: Sofort nach dem Übertragen, beide Dateien löschen, da diese Passwörter für die Roundcube Datenbank enthalten
• Folgende Befehle am Server eingeben:

cp /public/main.inc.db /var/www/roundcube/config
cp /public/db.inc.db /var/www/roundcube/config
rm /public/main.inc.db
rm /public/db.inc.db
chmod 600 /var/www/roundcube/config/main.inc.cfg
chmod 600 /var/www/roundcube/config/db.inc.cfg

Abschließen/Tunen der Konfiguration:

Domain für neue User:

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

Die Domain mail_domain in folgendem Eintrag ergänzen:

$rcmail_config['mail_domain'] = 'mail_domain';

Rechte/Eigentümer anpassen, sodass die Dateien vom Webserver les/schreibbar sind:

chown -R www-data:www-data /var/www/roundcube

In der Webseite Button CONTINUE anklicken

Nun sollten alle Ausgaben OK sein.

Hinweis: Bei Database ist evtl. ein Init Database notwendig. Danach sollte auch bei Database "alles grün" sein.

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)

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.