Webmail Setup · 5 min read · Jan 14, 2026

Utilisation de RoundCube Webmail avec ISPConfig 3 sur Debian Wheezy (Apache2)

Ce guide explique comment installer l’application webmail RoundCube sur un serveur Debian Wheezy exécutant ISPConfig et Apache2, et comment activer les plugins ISPConfig 3 pour RoundCube afin que les utilisateurs puissent effectuer des actions comme changer leurs mots de passe d’email depuis RoundCube. Roundcube webmail est un client IMAP multilingue basé sur un navigateur avec une interface utilisateur semblable à une application ; il est livré avec des fonctions telles que le support MIME, un carnet d’adresses, la manipulation de dossiers, la recherche de messages et la vérification orthographique.

Je ne garantis pas que cela fonctionnera pour vous !

1 Remarque Préliminaire

Ce tutoriel suppose que vous utilisez Apache2 comme serveur web sur votre serveur ISPConfig 3 ; ce tutoriel ne fonctionnera pas pour nginx. Je vais installer RoundCube à partir des dépôts Debian Wheezy - c’est une version raisonnablement récente (0.7.2.9 contre 0.9.1 (version stable actuelle)).

RoundCube sera configuré de manière à pouvoir être accessible depuis chaque vhost via l’alias /webmail (par exemple, http://www.example.com/webmail).

Si vous utilisez déjà une autre application webmail comme SquirrelMail, assurez-vous de la désactiver complètement ou au moins l’alias /webmail. Si vous avez installé SquirrelMail en tant que paquet Debian, vous pouvez trouver l’alias dans /etc/apache2/conf.d/squirrelmail.conf ; soit commentez l’alias pour désactiver simplement l’alias /webmail, soit commentez tout le fichier pour désactiver complètement SquirrelMail. N’oubliez pas de redémarrer Apache ensuite.

2 Création d’un Utilisateur Distant dans ISPConfig

Les plugins ISPConfig 3 pour RoundCube fonctionnent via l’API distante d’ISPConfig. Pour utiliser cette API, nous avons besoin d’un utilisateur distant. Pour créer un tel utilisateur, allez dans Système > Gestion des utilisateurs > Utilisateurs distants et cliquez sur le bouton Ajouter un nouvel utilisateur :

Fournissez un nom d’utilisateur et un mot de passe pour l’utilisateur…

… et activez les fonctions suivantes :

  • Fonctions serveur
  • Fonctions client
  • Fonctions utilisateur de mail
  • Fonctions alias de mail
  • Fonctions utilisateur de filtre anti-spam de mail
  • Fonctions de politique de filtre anti-spam de mail
  • Fonctions fetchmail de mail
  • Fonctions de liste blanche de filtre anti-spam de mail
  • Fonctions de liste noire de filtre anti-spam de mail
  • Fonctions de filtre utilisateur de mail

Puis cliquez sur Enregistrer.

3 Installation de RoundCube

Nous pouvons installer RoundCube comme suit :

apt-get install roundcube roundcube-plugins roundcube-plugins-extra

Vous verrez les questions suivantes :

Configurer la base de données pour roundcube avec dbconfig-common ? <– Oui
Type de base de données à utiliser par roundcube : <– mysql
Mot de passe de l’utilisateur administratif de la base de données : <– votremotdepasseadminsql (le mot de passe de l’utilisateur root MySQL)
Mot de passe de l’application MySQL pour roundcube : <– motdepasseroundcube
Confirmation du mot de passe : <– motdepasseroundcube

Cela créera une base de données MySQL appelée roundcube avec l’utilisateur MySQL roundcube et le mot de passe motdepasseroundcube.

Ensuite, ouvrez /etc/apache2/conf.d/roundcube…

vi /etc/apache2/conf.d/roundcube

… et ajoutez la ligne Alias /webmail /var/lib/roundcube. En plus de cela, ajoutez la configuration PHP à la section (j’ai mis en évidence les changements) :

| # Ces alias ne fonctionnent pas correctement avec plusieurs hôtes sur votre serveur apache # Décommentez-les pour les utiliser ou adaptez-les à votre configuration Alias /roundcube/program/js/tiny_mce/ /usr/share/tinymce/www/ Alias /roundcube /var/lib/roundcube Alias /webmail /var/lib/roundcube # Accès aux fichiers tinymce Options Indexes MultiViews FollowSymLinks AllowOverride None Order allow,deny allow from all Options +FollowSymLinks DirectoryIndex index.php AddType application/x-httpd-php .php php_flag magic_quotes_gpc Off php_flag track_vars On php_flag register_globals Off php_value include_path .:/usr/share/php # Ceci est nécessaire pour analyser /var/lib/roundcube/.htaccess. Voir son # contenu avant de définir AllowOverride sur None. AllowOverride All order allow,deny allow from all # Protection des répertoires de base : Options -FollowSymLinks AllowOverride None Options -FollowSymLinks AllowOverride None Order allow,deny Deny from all Options -FollowSymLinks AllowOverride None Order allow,deny Deny from all |

Redémarrez Apache ensuite :

/etc/init.d/apache2 restart

4 Configuration de RoundCube

Ouvrez /etc/roundcube/main.inc.php…

vi /etc/roundcube/main.inc.php

… et définissez $rcmail_config[‘default_host’] = ‘localhost’; (ou le nom d’hôte ou l’adresse IP de votre serveur de mail s’il est sur une machine distante) :

| [...] $rcmail_config['default_host'] = 'localhost'; [...] |

Sinon, RoundCube demandera un nom d’hôte avant chaque connexion, ce qui pourrait surcharger vos utilisateurs - nous voulons rendre l’utilisation aussi facile que possible.

Ensuite, installez les plugins ISPConfig 3 pour RoundCube :

cd /tmp  
git clone https://github.com/w2c/ispconfig3_roundcube.git  
cd /tmp/ispconfig3_roundcube/  
mv ispconfig3_* /var/lib/roundcube/plugins  
cd /var/lib/roundcube/plugins  
mv ispconfig3_account/config/config.inc.php.dist ispconfig3_account/config/config.inc.php

Ouvrez ispconfig3_account/config/config.inc.php…

vi ispconfig3_account/config/config.inc.php

… et remplissez les détails de connexion de votre utilisateur distant ISPConfig et l’URL de l’API distante - mon installation ISPConfig fonctionne sur https://192.168.0.100:8080, donc l’URL de l’API distante est https://192.168.0.100:8080/remote/ :

| |

Enfin, ouvrez à nouveau /etc/roundcube/main.inc.php…

vi /etc/roundcube/main.inc.php

… et activez le plugin jquerui ainsi que les plugins ISPConfig 3…

| // ---------------------------------- // PLUGINS // ---------------------------------- // Liste des plugins actifs (dans le répertoire plugins/) //$rcmail_config['plugins'] = array(); $rcmail_config['plugins'] = array("jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter"); [...] |

… et changez le skin de default à classic (sinon les plugins ISPConfig 3 ne fonctionneront pas) :

| [...] // nom du skin : dossier de skins/ $rcmail_config['skin'] = 'classic'; [...] |

C’est tout ; maintenant vous pouvez accéder à RoundCube sous l’alias /webmail (par exemple www.example.com/webmail). Connectez-vous avec l’adresse email et le mot de passe d’un compte email créé via ISPConfig :

Voici à quoi ressemble RoundCube :

Sous Paramètres > Compte, vous pouvez utiliser les plugins ISPConfig 3 pour RoundCube pour modifier vos paramètres, par exemple…

… vous pouvez définir un nouveau mot de passe pour votre compte email sans utiliser ISPConfig :

5 Liens

Share: X/Twitter LinkedIn
#Webmail Setup

Recevez de nouveaux articles dans votre boîte de réception.

Aucun spam. Désabonnez-vous à tout moment.