Roundcube

Roundcube openen

• Open de volgende URL in je browser: https://<SERVER_IP>
• De installatie gebruikt een zelfondertekend TLS-certificaat, dus je browser toont een beveiligingswaarschuwing. Accepteer het certificaat om verder te gaan.
• HTTP-verzoeken op poort 80 worden automatisch doorgestuurd naar HTTPS.

Inloggen

• Roundcube maakt geen mailboxaccounts aan en slaat ze ook niet op.
• Log in met de gebruikersnaam en het wachtwoord van een bestaande mailbox op je ingestelde IMAP-server.

Je mailserver instellen

De verbindingsinstellingen voor de mailserver staan in: /root/roundcube/.env

Belangrijke instellingen:

• IMAP-host: IMAP_HOST
• IMAP-poort: IMAP_PORT
• SMTP-host: SMTP_HOST
• SMTP-poort: SMTP_PORT
• Domein van de gebruikersnaam: USERNAME_DOMAIN

De standaardconfiguratie gebruikt voorbeeldwaarden:

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

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

Vervang ze door de echte hostnaam van je mailserver.

Pas gewijzigde instellingen toe met:

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

Typen TLS-verbindingen

Gebruik het juiste voorvoegsel voor je 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.

Zelfondertekende mailservercertificaten

Gebruikt je IMAP- of SMTP-server een zelfondertekend certificaat, dan kan Roundcube de verbinding weigeren.

De optionele instellingen voor TLS-verificatie staan in: /root/roundcube/config/custom.inc.php

Haal de betreffende IMAP- of SMTP-verbindingsopties alleen uit commentaar en stel ze in als je de mailserver en het netwerk vertrouwt.

Pas de configuratie toe:

cd /root/roundcube && docker compose restart roundcube

Plug-ins en skin

De standaardinstallatie schakelt in:

• archive
• zipdownload

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

Bijvoorbeeld:

PLUGINS=archive,zipdownload,managesieve

Pas de wijzigingen toe:

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

Bundled plugins such as managesieve, markasjunk, en 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 beheren

Status van de containers bekijken:

cd /root/roundcube && docker compose ps

Logs bekijken:

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

Roundcube opnieuw starten:

cd /root/roundcube && docker compose restart roundcube

Stop de stack:

cd /root/roundcube && docker compose down

Stack starten:

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

Belangrijke bestanden en mappen

• Installatiepad: /root/roundcube
• Compose-bestand: /root/roundcube/docker-compose.yml
• Omgevingsbestand: /root/roundcube/.env
• Aanvullende configuratie: /root/roundcube/config/custom.inc.php
• Databasevolume: /var/lib/docker/volumes/roundcube_db_data
• Nginx-configuratie: /etc/nginx/sites-available/roundcube
• TLS-certificaat: /etc/nginx/ssl/roundcube.crt
• Privésleutel TLS: /etc/nginx/ssl/roundcube.key

Domein en HTTPS

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

2. Installeer 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. Vraag een TLS-certificaat aan:

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

5. Bewerk /etc/nginx/sites-available/roundcube en werk de ssl_certificate en ssl_certificate_key directieven bij om je Let's Encrypt-certificaat te gebruiken.

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. Test de configuratie:

nginx -t

7. Herlaad NGINX:

systemctl reload nginx

8. Open je browser en ga naar: https://yourdomain.com

Opmerkingen

• Roundcube is publicly accessible through Nginx on ports 80 en 443.
• The Roundcube container itself listens only on 127.0.0.1:8000.
• MariaDB is een interne Docker-service en wordt niet rechtstreeks aan de host blootgesteld.
• De standaard webinterface gebruikt een zelfondertekend TLS-certificaat.
• The upload limit is set to 25 MB; increase both UPLOAD_MAX_FILESIZE and Nginx's client_max_body_size for larger uploads.
• Pas de configuratie van Roundcube aan je voorkeuren aan.