Roundcube

Accéder à Roundcube

• Ouvrez l'URL suivante dans votre navigateur : https://<SERVER_IP>
• L'installation utilise un certificat TLS auto-signé, votre navigateur affichera donc un avertissement de sécurité. Acceptez le certificat pour continuer.
• Les requêtes HTTP sur le port 80 sont automatiquement redirigées vers HTTPS.

Connexion

• Roundcube ne crée ni ne stocke de comptes de messagerie.
• Connectez-vous avec le nom d'utilisateur et le mot de passe d'une boîte aux lettres existante sur le serveur IMAP configuré.

Configurer votre serveur de messagerie

Les paramètres de connexion au serveur de messagerie sont stockés dans : /root/roundcube/.env

Paramètres importants :

• Hôte IMAP : IMAP_HOST
• Port IMAP : IMAP_PORT
• Hôte SMTP : SMTP_HOST
• Port SMTP : SMTP_PORT
• Domaine du nom d'utilisateur : USERNAME_DOMAIN

La configuration par défaut contient des valeurs d'exemple :

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

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

Remplacez-les par le nom d'hôte réel de votre serveur de messagerie.

Après avoir modifié les paramètres, appliquez-les avec :

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

Types de connexion TLS

Utilisez le préfixe adapté à votre serveur de messagerie :

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

Certificats auto-signés du serveur de messagerie

Si votre serveur IMAP ou SMTP utilise un certificat auto-signé, Roundcube peut refuser la connexion.

Les paramètres facultatifs de vérification TLS se trouvent dans : /root/roundcube/config/custom.inc.php

Ne décommentez et ne configurez les options de connexion IMAP ou SMTP concernées que si vous avez confiance dans le serveur de messagerie et le réseau.

Appliquez la configuration :

cd /root/roundcube && docker compose restart roundcube

Plugins et thème

L'installation par défaut active :

• archive
• zipdownload

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

Par exemple :

PLUGINS=archive,zipdownload,managesieve

Appliquez les modifications :

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

Bundled plugins such as managesieve, markasjunk, et 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.

Gérer Roundcube

Afficher l'état des conteneurs :

cd /root/roundcube && docker compose ps

Voir les logs :

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

Redémarrer Roundcube :

cd /root/roundcube && docker compose restart roundcube

Arrêtez la pile :

cd /root/roundcube && docker compose down

Démarrez la pile :

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

Fichiers et répertoires importants

• Chemin d'installation : /root/roundcube
• Fichier Compose : /root/roundcube/docker-compose.yml
• Fichier d'environnement : /root/roundcube/.env
• Configuration supplémentaire : /root/roundcube/config/custom.inc.php
• Volume de la base de données : /var/lib/docker/volumes/roundcube_db_data
• Configuration Nginx : /etc/nginx/sites-available/roundcube
• Certificat TLS : /etc/nginx/ssl/roundcube.crt
• Clé privée TLS : /etc/nginx/ssl/roundcube.key

Domaine et HTTPS

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

2. Installez 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. Émettez un certificat TLS :

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

5. Modifiez /etc/nginx/sites-available/roundcube et mettez à jour les ssl_certificate et ssl_certificate_key directives pour utiliser votre certificat Let's Encrypt.

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. Testez la configuration :

nginx -t

7. Rechargez NGINX :

systemctl reload nginx

8. Ouvrez votre navigateur et accédez à : https://yourdomain.com

Remarques

• Roundcube is publicly accessible through Nginx on ports 80 et 443.
• The Roundcube container itself listens only on 127.0.0.1:8000.
• MariaDB est un service Docker interne et n'est pas exposé directement à l'hôte.
• L'interface web par défaut utilise un certificat TLS auto-signé.
• The upload limit is set to 25 MB; increase both UPLOAD_MAX_FILESIZE and Nginx's client_max_body_size for larger uploads.
• Adaptez la configuration de Roundcube à vos besoins.