Roundcube Webmail: guida completa all'installazione, funzioni e personalizzazione

16 ott 2025

Roundcube è un client di posta elettronica basato su browser. Offre un accesso semplice per gestire le email tramite un'interfaccia web.

Roundcube può essere installato in due modi: tramite Docker Compose oppure direttamente su un server Ubuntu per un approccio più manuale.

La seguente guida è un manuale completo che copre tutto, dai prerequisiti e l'installazione alla risoluzione dei problemi e alla gestione degli account in Roundcube Webmail. Iniziamo con il perché.

Perché usare Roundcube Webmail

Ecco alcune delle principali caratteristiche che rendono Roundcube un client di posta elettronica eccezionale:

Interfaccia intuitiva: l'interfaccia di Roundcube è moderna, semplice e facile da usare.
Supporto IMAP e SMTP: supporta entrambi i protocolli, garantendo la compatibilità con la maggior parte dei server di posta.
Account multipli: gli utenti possono configurare più account nella stessa interfaccia e passare facilmente da uno all'altro.
Basato sul web: tutto ciò che serve è un browser per accedere alle email, ideale per chi utilizza più dispositivi.
Estendibile e personalizzabile: Roundcube è open source. Con centinaia di plugin disponibili, puoi adattarlo alle tue esigenze.
Rubrica: l'integrazione della rubrica consente di importare contatti esistenti o crearne di nuovi manualmente.

Prerequisiti

Per seguire questo tutorial, avrai bisogno di:

Un server Ubuntu: questa guida utilizza Ubuntu 22.04, ma funziona anche su altre versioni moderne.
Docker e Docker Compose (per il Metodo 1): se non installati, puoi farlo con i seguenti comandi:

sudo apt update
sudo apt install docker docker-compose

Metodo 1: Configurare Roundcube con Docker Compose (Consigliato)

I container Docker includono tutte le dipendenze necessarie per semplificare il processo di configurazione. Ecco un file docker-compose.yml funzionante per avviare Roundcube Webmail con i plugin thunderbird_labels, show_folder_size e tls_icon.

version: '3'

services:
  roundcubemail:
    image: roundcube/roundcubemail:latest
    container_name: roundcubemail
    volumes:
      - ./www:/var/www/html
      - ./db/sqlite:/var/roundcube/db
    ports:
      - 9002:80
    environment:
      ROUNDCUBEMAIL_DB_TYPE: sqlite
      ROUNDCUBEMAIL_SKIN: elastic
      ROUNDCUBEMAIL_DEFAULT_HOST: "ssl://imap.gmail.com"
      ROUNDCUBEMAIL_SMTP_SERVER: "ssl://smtp.gmail.com"
      ROUNDCUBEMAIL_DEFAULT_PORT: 993
      ROUNDCUBEMAIL_SMTP_PORT: 465
      ROUNDCUBEMAIL_COMPOSER_PLUGINS: "weird-birds/thunderbird_labels,jfcherng-roundcube/show-folder-size,germancoding/tls_icon:^1.2"
      ROUNDCUBEMAIL_PLUGINS: thunderbird_labels, show_folder_size, tls_icon

Spiegazione delle variabili d'ambiente:

ROUNDCUBEMAIL_SKIN: indica il tema dell'interfaccia. "Elastic" è quello moderno, mentre "Classic" è più semplice.
ROUNDCUBEMAIL_DEFAULT_HOST: host IMAP predefinito a cui Roundcube si connetterà.
ROUNDCUBEMAIL_DEFAULT_PORT: porta IMAP.
ROUNDCUBEMAIL_SMTP_SERVER: server SMTP utilizzato per inviare email.
ROUNDCUBE_SMTP_PORT: porta SMTP.
ROUNDCUBEMAIL_COMPOSER_PLUGINS: plugin che migliorano l’esperienza d’uso e l’aspetto.
ROUNDCUBEMAIL_PLUGINS: attiva i plugin installati tramite la variabile precedente.

Il tuo provider di posta ti fornirà i dettagli del server IMAP, porta IMAP, server SMTP e impostazioni SMTP. Adatta queste variabili in base alle specifiche e al tipo di crittografia utilizzata (SSL/TLS).

Per distribuire questo file docker-compose, assicurati di avere Docker e Docker Compose installati:

docker --version && docker-compose --version

Avvia il servizio Docker:

systemctl start docker

Esegui il file:

docker-compose up

Potrebbero volerci 2–3 minuti affinché Roundcube sia completamente operativo su <l'indirizzo-IP>:9092. Per iniziare a gestire le tue email, inserisci le credenziali fornite dal tuo provider di posta.

Se utilizzi Gmail o Outlook, il nome utente sarà il tuo indirizzo email completo (@gmail o @outlook).

Dopo aver effettuato l’accesso, vedrai un’interfaccia simile.

Metodo 2: Installazione diretta su server Ubuntu

Roundcube è un'applicazione LAMP scritta in PHP e compatibile con diversi database, tra cui MySQL, PostgreSQL e SQLite.

Passaggio 1: Installare PHP e Apache

Prima dell’installazione, aggiorna l’elenco dei pacchetti:

sudo apt update
sudo apt install php apache2

Installa e abilita le seguenti estensioni PHP:

sudo apt install php-mbstring php-xml php-imap php-sqlite3 php-json php-curl php-zip php-gd php-intl

Ecco cosa fa ciascuna estensione:

php-mbstring: supporto per codifiche multibyte
php-xml: consente di lavorare con documenti XML
php-imap: permette di connettersi ai server IMAP
php-sqlite3: adattatore PHP per database SQLite
php-json: gestisce la codifica e decodifica JSON
php-curl: invia richieste HTTP tramite curl
php-zip: legge e scrive file ZIP
php-gd: consente la manipolazione delle immagini
php-intl: supporta lingue e impostazioni regionali

Passaggio 2: Scaricare il codice sorgente di Roundcube

Puoi scaricare il codice sorgente da https://roundcube.net/download/. Per facilitare l’implementazione, scegli la versione completa e stabile.

Scarica l’applicazione nella directory /var/www:

cd /var/www
sudo wget https://github.com/roundcube/roundcubemail/releases/download/1.6.10/roundcubemail-1.6.10-complete.tar.gz

Passaggio 3: Estrarre e impostare i permessi

Un modo semplice per consentire ad Apache di leggere e scrivere nella directory è modificare la proprietà all’utente www-data:

sudo tar xvf roundcubemail-1.6.10-complete.tar.gz
sudo chown -R www-data:www-data roundcube-1.6.10
cd roundcube-1.6.10

Passaggio 4: Configurare il file di configurazione

Il file di configurazione determina i plugin utilizzati, l’interfaccia e i server SMTP/IMAP.

Crea una copia del file di configurazione predefinito (assicurati di essere nella directory /var/www/roundcube-1.6.10) e modificalo:

sudo cp config/config.inc.php.sample config/config.inc.php

sudo nano config.inc.php

Ecco un esempio di configurazione per Outlook. Modifica db_dsnw, imap_host e smtp_host in base al tuo provider. Questa configurazione utilizza un database SQLite per semplicità:

$config[‘db_dsnw’] = ‘sqlite:////var/www/roundcubemail-1.6.10/config/db.sqlite?mode=0640’;
$config[‘imap_host’] = ‘ssl://imap.office365.com:993’;
$config[‘smtp_host’] = ‘ssl://smtp-mail.outlook.com:587’;

Per utilizzare alcuni plugin, scaricali nella directory dei plugin o gestiscili con Composer, poi attivali nel file di configurazione.

Passaggio 5: Configurare Apache

Crea un file roundcube_site.conf in /etc/apache2/sites-available con il seguente contenuto:

<VirtualHost *:80>
    DocumentRoot /var/www/roundcubemail-1.6.10
    # ServerName roundcube.CHANGEME_YOURDOMAIN.com  # Sostituiscilo

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined

    <Directory /var/www/roundcubemail-1.6.10>
        AllowOverride All
        Require all granted
    </Directory>

   # Blocca l'accesso al database
   <FilesMatch "\.sqlite$">
    Require all denied
   </FilesMatch>

</VirtualHost>

Abilita il nuovo sito Apache:

sudo a2ensite roundcube_site.conf

Disabilita il sito predefinito per evitare conflitti:

sudo a2dissite 000_default.conf

Ricarica Apache per applicare le modifiche:

sudo systemctl reload apache2

Passaggio 6: Avvio e installazione

Accedi all’interfaccia di Roundcube visitando l’indirizzo IP del tuo server. Ti verranno richiesti nome utente e password che puoi ottenere dal tuo provider di posta.

Risoluzione dei problemi

Se l’installazione non funziona, controlla il file errors.log.

Controlla anche i log di Apache per ulteriori informazioni:

tail -f /var/log/apache2/access.log
tail -f /var/log/apache2/error.log

Gestione di più account

Per aggiungere altri account, vai su Impostazioni > Identità > Crea.

Importare contatti

Puoi importare tutti i contatti precedenti da un file vCard o CSV tramite la scheda Contatti, facendo clic sull’icona Importa in alto.

Se vuoi importare CardDAV, aggiungi il plugin roundcube/carddav.

I Destinatari raccolti mostreranno un elenco dei contatti con cui hai già comunicato. Allo stesso modo, i Mittenti fidati mostreranno un elenco di mittenti conosciuti.

Plugin utili per Roundcube

Ecco alcuni dei plugin più popolari:

Larry: il tema Larry.
Contextmenu: abilita i menu contestuali con clic destro.
Gravatar: mostra immagini Gravatar per le email.
Identity_switch: consente di passare tra diverse identità utente.
Advanced Search: ricerca rapida nelle email.
Sauserprefs: aiuta a combattere lo spam.
Calendar: aggiunge integrazione con il calendario.
Roundcube_caldav: CalDAV permette di gestire eventi su sistemi come Google Calendar, ottimo per il lavoro di squadra.
Identity SMTP : consente configurazioni SMTP differenti per ogni identità.
Carddav: metodo standard per archiviare e importare contatti in formato vCard.
Customizr: consente di personalizzare loghi e stili.
Fail2ban: mostra il numero di tentativi di accesso falliti.
Html5_notifier: invia notifiche desktop per nuove email.
Thunderbird_labels: assegna etichette alle email.

Alternative a Roundcube

Se Roundcube non soddisfa le tue esigenze, ecco alcune alternative:

Horde Webmail: suite integrata di email, calendario e gestione attività. Ottimizza la produttività di squadra.
Zimbra Webmail: disponibile in versione open source e commerciale; noto per la sicurezza, i filtri antispam e l’autenticazione a due fattori.
Rainloop: design moderno e minimale, non richiede database e si distingue per la sua semplicità.

Roundcube Webmail: è la scelta giusta per te?

Roundcube offre centinaia di plugin per personalizzare l’esperienza. Con Docker, può essere installato in pochi minuti.

Se hai familiarità con la gestione server e cerchi una soluzione webmail leggera e open source, Roundcube è ideale. Se invece desideri funzioni più avanzate o vuoi evitare l’autohosting, considera altre opzioni.

Roundcube Webmail: guida completa all'installazione, funzioni e personalizzazione

Perché usare Roundcube Webmail Copia link

Prerequisiti Copia link

Metodo 1: Configurare Roundcube con Docker Compose (Consigliato) Copia link

Metodo 2: Installazione diretta su server Ubuntu Copia link

Passaggio 1: Installare PHP e Apache Copia link

Passaggio 2: Scaricare il codice sorgente di Roundcube Copia link

Passaggio 3: Estrarre e impostare i permessi Copia link

Passaggio 4: Configurare il file di configurazione Copia link

Passaggio 5: Configurare Apache Copia link

Passaggio 6: Avvio e installazione Copia link

Risoluzione dei problemi Copia link

Gestione di più account Copia link

Importare contatti Copia link

Plugin utili per Roundcube Copia link

Alternative a Roundcube Copia link

Roundcube Webmail: è la scelta giusta per te? Copia link