Roundcube

Roundcube aufrufen

• Öffnen Sie die folgende URL in Ihrem Browser: https://<SERVER_IP>
• Die Installation verwendet ein selbstsigniertes TLS-Zertifikat, daher zeigt Ihr Browser eine Sicherheitswarnung. Akzeptieren Sie das Zertifikat, um fortzufahren.
• HTTP-Anfragen auf Port 80 werden automatisch auf HTTPS umgeleitet.

Anmeldung

• Roundcube legt keine Postfachkonten an und speichert auch keine.
• Melden Sie sich mit Benutzernamen und Passwort eines vorhandenen Postfachs auf Ihrem konfigurierten IMAP-Server an.

Mailserver konfigurieren

Die Verbindungseinstellungen zum Mailserver liegen in: /root/roundcube/.env

Wichtige Einstellungen:

• IMAP-Host: IMAP_HOST
• IMAP-Port: IMAP_PORT
• SMTP-Host: SMTP_HOST
• SMTP-Port: SMTP_PORT
• Domain des Benutzernamens: USERNAME_DOMAIN

Die Standardkonfiguration enthält Platzhalterwerte:

IMAP_HOST=ssl://mail.example.org
IMAP_PORT=993

SMTP_HOST=tls://mail.example.org
SMTP_PORT=587

Ersetzen Sie sie durch den tatsächlichen Hostnamen Ihres Mailservers.

Übernehmen Sie geänderte Einstellungen mit:

cd /root/roundcube && docker compose up -d

TLS-Verbindungsarten

Verwenden Sie das passende Präfix für Ihren Mailserver:

• ssl://: Implicit TLS, typically used with IMAP port 993 or SMTP port 465.
• tls://: STARTTLS, typically used with IMAP port 143 or SMTP port 587.

Selbstsignierte Mailserver-Zertifikate

Wenn Ihr IMAP- oder SMTP-Server ein selbstsigniertes Zertifikat nutzt, kann Roundcube die Verbindung ablehnen.

Die optionalen Einstellungen zur TLS-Prüfung finden Sie in: /root/roundcube/config/custom.inc.php

Kommentieren Sie die betreffenden IMAP- oder SMTP-Verbindungsoptionen nur dann aus und konfigurieren Sie sie, wenn Sie dem Mailserver und dem Netzwerk vertrauen.

Die Konfiguration anwenden:

cd /root/roundcube && docker compose restart roundcube

Plugins und Skin

Die Standardinstallation aktiviert:

• archive
• zipdownload

Plugins are configured through the PLUGINS variable in: /root/roundcube/.env

Beispiel:

PLUGINS=archive,zipdownload,managesieve

Änderungen übernehmen:

cd /root/roundcube && docker compose up -d

Bundled plugins such as managesieve, markasjunk, und enigma can be enabled by adding them to PLUGINS, when supported by the image.

For third-party plugins, add them to ROUNDCUBEMAIL_COMPOSER_PLUGINS in the Compose file and include their names in PLUGINS.

Roundcube verwalten

Status der Container anzeigen:

cd /root/roundcube && docker compose ps

Logs ansehen:

cd /root/roundcube && docker compose logs -f

Roundcube neu starten:

cd /root/roundcube && docker compose restart roundcube

Stack stoppen:

cd /root/roundcube && docker compose down

Stack starten:

cd /root/roundcube && docker compose up -d

Wichtige Dateien und Verzeichnisse

• Installationspfad: /root/roundcube
• Compose-Datei: /root/roundcube/docker-compose.yml
• Umgebungsdatei: /root/roundcube/.env
• Zusätzliche Konfiguration: /root/roundcube/config/custom.inc.php
• Datenbankvolume: /var/lib/docker/volumes/roundcube_db_data
• Nginx-Konfiguration: /etc/nginx/sites-available/roundcube
• TLS-Zertifikat: /etc/nginx/ssl/roundcube.crt
• Privater TLS-Schlüssel: /etc/nginx/ssl/roundcube.key

Domain und HTTPS

1. Point your domain to the server's IP address (e.g., yourdomain.com;).

2. Installiere Certbot:

apt update
apt install -y certbot python3-certbot-nginx

3. Edit NGINX config and replace both server_name _; entries with your domain (e.g., server_name yourdomain.com;):

vim /etc/nginx/sites-available/roundcube

4. Stellen Sie ein TLS-Zertifikat aus:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

5. Bearbeiten Sie /etc/nginx/sites-available/roundcube und aktualisieren Sie die ssl_certificate und ssl_certificate_key Direktiven, damit sie Ihr Let's Encrypt-Zertifikat verwenden.

Before:
    ssl_certificate     /etc/nginx/ssl/roundcube.crt;
    ssl_certificate_key /etc/nginx/ssl/roundcube.key;
After:
    ssl_certificate  /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

6. Prüfen Sie die Konfiguration:

nginx -t

7. Laden Sie NGINX neu:

systemctl reload nginx

8. Browser öffnen und folgende Adresse aufrufen: https://yourdomain.com

Hinweise

• Roundcube is publicly accessible through Nginx on ports 80 und 443.
• The Roundcube container itself listens only on 127.0.0.1:8000.
• MariaDB ist ein interner Docker-Dienst und wird dem Host nicht direkt zugänglich gemacht.
• Die Standard-Weboberfläche verwendet ein selbstsigniertes TLS-Zertifikat.
• The upload limit is set to 25 MB; increase both UPLOAD_MAX_FILESIZE and Nginx's client_max_body_size for larger uploads.
• Passen Sie die Roundcube-Konfiguration an Ihre Bedürfnisse an.