Roundcube

Accedere a Roundcube

• Apri il seguente URL nel tuo browser: https://<SERVER_IP>
• L'installazione usa un certificato TLS autofirmato, quindi il browser mostrerà un avviso di sicurezza. Accetta il certificato per continuare.
• Le richieste HTTP sulla porta 80 vengono reindirizzate automaticamente a HTTPS.

Accesso

• Roundcube non crea né memorizza account di posta.
• Accedi con nome utente e password di una casella già esistente sul server IMAP configurato.

Configurare il server di posta

Le impostazioni di connessione al server di posta si trovano in: /root/roundcube/.env

Impostazioni importanti:

• Host IMAP: IMAP_HOST
• Porta IMAP: IMAP_PORT
• Host SMTP: SMTP_HOST
• Porta SMTP: SMTP_PORT
• Dominio del nome utente: USERNAME_DOMAIN

La configurazione predefinita usa valori segnaposto:

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

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

Sostituiscili con il nome host reale del tuo server di posta.

Dopo aver modificato le impostazioni, applicale con:

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

Tipi di connessione TLS

Usa il prefisso adatto al tuo server di posta:

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

Certificati autofirmati del server di posta

Se il tuo server IMAP o SMTP usa un certificato autofirmato, Roundcube può rifiutare la connessione.

Le impostazioni facoltative di verifica TLS si trovano in: /root/roundcube/config/custom.inc.php

Togli il commento e configura le relative opzioni di connessione IMAP o SMTP solo se ti fidi del server di posta e della rete.

Applica la configurazione:

cd /root/roundcube && docker compose restart roundcube

Plugin e skin

L'installazione predefinita attiva:

• archive
• zipdownload

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

Ad esempio:

PLUGINS=archive,zipdownload,managesieve

Applica le modifiche:

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

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

Gestire Roundcube

Visualizzare lo stato dei container:

cd /root/roundcube && docker compose ps

Visualizza i log:

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

Riavviare Roundcube:

cd /root/roundcube && docker compose restart roundcube

Fermare lo stack:

cd /root/roundcube && docker compose down

Avviare lo stack:

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

File e directory importanti

• Percorso di installazione: /root/roundcube
• File Compose: /root/roundcube/docker-compose.yml
• File di ambiente: /root/roundcube/.env
• Configurazione aggiuntiva: /root/roundcube/config/custom.inc.php
• Volume del database: /var/lib/docker/volumes/roundcube_db_data
• Configurazione Nginx: /etc/nginx/sites-available/roundcube
• Certificato TLS: /etc/nginx/ssl/roundcube.crt
• Chiave privata TLS: /etc/nginx/ssl/roundcube.key

Dominio e HTTPS

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

2. Installa 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. Emetti un certificato TLS:

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

5. Modifica /etc/nginx/sites-available/roundcube e aggiorna le ssl_certificate e i piani ssl_certificate_key direttive per usare il tuo certificato 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. Verifica la configurazione:

nginx -t

7. Ricarica NGINX:

systemctl reload nginx

8. Apri il browser e visita: https://yourdomain.com

Note

• Roundcube is publicly accessible through Nginx on ports 80 e i piani 443.
• The Roundcube container itself listens only on 127.0.0.1:8000.
• MariaDB è un servizio Docker interno e non viene esposto direttamente all'host.
• L'interfaccia web predefinita usa un certificato TLS autofirmato.
• The upload limit is set to 25 MB; increase both UPLOAD_MAX_FILESIZE and Nginx's client_max_body_size for larger uploads.
• Modifica la configurazione di Roundcube secondo le tue preferenze.