RoundCube Webmail Sur Votre Serveur ISPConfig En 10 Étapes Faciles

Version 2.1
Auteur : [at] bb-hosting [dot] org>

Il existe de jolis packages RoundCube disponibles pour ISPConfig à http://www.ispconfig.org/downloads.htm

Le package RoundCube de votre choix peut être installé avec le Gestionnaire de mise à jour ISPConfig. Cependant, si vous préférez configurer RoundCube sur votre serveur ISPConfig dans l’espace web de votre choix fonctionnant sur le port 80, vous pouvez utiliser ce “Comment faire” comme alternative.

Dans ce comment faire, j’utiliserai comme exemple :

nom de domaine webmail.myhostingcompany.tld
nom de base de données MySQL : web_db1
nom d’utilisateur MySQL : web1_u1
mot de passe utilisateur MySQL : mysqlpassword
version de RoundCube 0.1.1

Lorsque vous aurez terminé ce “Comment faire”, vous aurez un joli client webmail à l’URL http://webmail.myhostingcompany.tld.

L’étape 2 n’est pas vraiment nécessaire mais peut être très pratique si vous souhaitez télécharger/téléverser votre site web en utilisant FTP. Cela est très utile si vous souhaitez personnaliser le site web RoundCube sur votre bureau local.

Voici comment procéder :

Étape 1 - Créer un site web :

Dans ISPConfig, créez un site web via “Nouveau site” dans le menu principal.
Dans l’onglet appelé “Base”, utilisez webmail pour le nom d’hôte et myhostingcompany.tld pour le nom de domaine. Activez MySQL et les scripts PHP pour ce site web mais désactivez le mode sécurisé PHP. RoundCube utilise des fichiers .htaccess. Pour autoriser ces fichiers dans votre site web, ajoutez les lignes suivantes dans le champ de directive Apache de votre site web :

Options FollowSymLinks AllowOverride All

Étape 2 – Créer un utilisateur Administrateur pour le site web :

Dans ISPConfig, créez un utilisateur Administrateur, afin que vous puissiez télécharger le site web plus tard via FTP :
Dans le menu principal, sélectionnez “ISP Manager”, sélectionnez votre nouveau site web appelé webmail.myhostingcompany.tld dans l’arborescence et appuyez sur l’onglet “Utilisateur et Email”.
Appuyez sur “nouveau” et définissez un nouvel utilisateur et son adresse email. Donnez à cet utilisateur des droits d’administrateur et appuyez sur “Enregistrer”.

Étape 3 - Créer une base de données MySQL pour le site web :

Cliquez sur l’onglet appelé “Options” et créez une nouvelle base de données pour le site web.
ISPConfig vous montrera :
Nom de la base de données : web1_db1 (exemple)
Utilisateur de la base de données : web1_u1 (exemple)
Ensuite, vous définissez un mot de passe pour l’utilisateur de la base de données et appuyez sur “Enregistrer”.

Étape 4 – Télécharger/extraire les packages et supprimer certains fichiers :

Connectez-vous à votre serveur en tant que root.
La version la plus stable à ce moment est la version 0.1.1.
Changez de répertoire vers le web où vous souhaitez télécharger RoundCube en donnant la commande :

cd /var/www/web1/web/
wget http://downloads.sourceforge.net/roundcubemail/roundcubemail-0.1.1.tar.gz

Extrayez RoundCube avec la commande :

tar xzf roundcubemail-0.1.1.tar.gz

Supprimez les fichiers tar.gz :

rm *.tar.gz

Étape 5 - Déplacer les fichiers vers le répertoire web et supprimer le répertoire vide :

cd roundcubemail-0.1.1
mv * ../
cd ../
rmdir roundcubemail-0.1.1

Étape 6 – Rendre le répertoire temp et logs lisible/écrivable pour Apache :

Dans votre dossier web /var/www/web1/web, vous donnez à votre processus de serveur web des privilèges de lecture/écriture pour tous les dossiers dans le répertoire temp et logs en donnant ces commandes :

chown -R www-data:www-data temp chown -R www-data:www-data logs

(C’est ainsi que cela fonctionne sur Debian Linux, d’autres distributions peuvent différer).
Il est également possible de chmod les répertoires temp et logs à 777 mais ce n’est pas sécurisé.

Si vous utilisez php5-cgi avec suPHP activé sur votre serveur ISPConfig, exécutez les commandes suivantes :

cd /var/www/web1/

chown -R -v -f webadmin:web1 web/

(Rappelez-vous que “web1” et le nom d’utilisateur “webadmin” sont selon mon exemple, utilisez votre propre numéro web et nom d’utilisateur à la place !)

Étape 7 – Configurer RoundCube (manuellement) :

Avec cette méthode, vous avez plus d’options disponibles !
Naviguez vers le dossier config avec la commande :

cd config

Ici, vous trouverez deux fichiers, db.inc.php.dist et main.inc.php.dist.
Renommez main.inc.php.dist et db.inc.php.dist en supprimant .dist.
Vous avez maintenant deux fichiers db.inc.php et main.inc.php.

Modifications à apporter dans le fichier db.inc.php :

Ouvrez db.inc.php dans un éditeur de texte.
Nous donnons à RoundCube un moyen d’accéder à notre nouvelle base de données créée en changeant la ligne :

$rcmail_config[’db_dsnw’]=’mysql:// roundcube:pass@localhost/roundcubemail’;

en :

$rcmail_config[’db_dsnw’]=’mysql:// web1_u1:mysqlpassword@localhost/web1_db1’;

Assurez-vous d’avoir également la ligne suivante :

$rcmail_config[‘db_backend’] = ‘mdb2’;

Modifications à apporter dans le fichier main.inc.php :

Ouvrez votre fichier main.inc.php avec un éditeur de texte :

Modifications à apporter dans main.inc.php :

Changez la ligne :

$rcmail_config[’default_host’] = ‘’;

$rcmail_config[’default_host’] = ‘localhost’;

ou en :

$rcmail_config[’default_host’] = ‘’;

si vous préférez choisir un nom de serveur à la connexion.

Vous pouvez garder tous les paramètres de configuration par défaut, mais assurez-vous d’avoir les lignes suivantes :

$rcmail_config[‘default_port’] = 143;

$rcmail_config[‘virtuser_file’] = ‘/etc/postfix/virtusertable’;

$rcmail_config[‘smtp_server’] = ‘’;

$rcmail_config[‘smtp_port’] = 25;

$rcmail_config[‘create_default_folders’] = TRUE;

$rcmail_config[‘prefer_html’] = TRUE;

$rcmail_config[‘htmleditor’] = FALSE;

$rcmail_config[‘preview_pane’] = TRUE;

$rcmail_config[‘enable_spellcheck’] = TRUE;

La ligne suivante nécessite une attention particulière pour des raisons de sécurité :

$rcmail_config[‘des_key’] = ‘’;

Remplacez ‘’ par une chaîne de exactement 24 caractères !

Lorsqu’un utilisateur se connecte avec l’adresse email pour la première fois, dans la section identités de RoundCube, l’adresse email sera affichée comme : [email protected]. Comme nous voulons que l’adresse email soit affichée comme [email protected], faites ce qui suit :

Changez la ligne 709 dans le fichier /program/include/main.inc de :

709 $line = trim($line);

à :

709 $line = trim(str_replace(“www.”, “”, $line));

Assurez-vous d’avoir la ligne suivante dans votre fichier php.ini :

; Magic quotes pour les données GET/POST/Cookie entrantes.
magic_quotes_gpc = Off

S’il était nécessaire de changer la ligne de

magic_quotes_gpc = On

magic_quotes_gpc = Off

alors redémarrez Apache2 ensuite avec la commande :

/etc/init.d/apache2 restart

Étape 8 – Configurer RoundCube (méthode alternative utilisant le script d’installation) :

RoundCube est livré avec un joli script d’installation. Cette méthode alternative est un moyen très facile de configurer RoundCube. Dans votre navigateur, visitez votre nouveau site RoundCube à http://webmail.yourhostingcompany.tld/installer/index.php.

Image RoundCube 1

Lisez les exigences de base et appuyez sur le bouton “DÉBUTER L’INSTALLATION”.
À l’écran “Vérifier l’environnement”, les exigences système sont vérifiées.

Si une ou plusieurs exigences système sont affichées en rouge, la configuration doit être modifiée pour garantir que RoundCube fonctionnera correctement.

Sur un serveur ISPConfig par défaut, tout devrait être ok, vous devez probablement juste désactiver magic_quotes_gpc dans votre fichier php.ini.
Si les exigences système sont bonnes, appuyez sur le bouton “SUIVANT”.

À l’écran “Créer la config”, vous pouvez définir la configuration système requise.
Définissez les paramètres de configuration, comme nous l’avons fait précédemment à l’étape 7 de ce comment faire.
Définissez les paramètres de base de données selon notre base de données MySQL comme nous l’avons défini dans ISPConfig :

Image RoundCube 2

Enfin, appuyez sur le bouton “CRÉER LA CONFIG”.

Deux configurations sont affichées.
Copiez la première configuration dans le fichier main.inc.php et la deuxième configuration dans le fichier db.inc.php. Enregistrez ces fichiers dans le répertoire config/ de votre installation RoundCube.
Appuyez sur le bouton “Continuer”

Image RoundCube 3

Les résultats sont affichés.
Maintenant, nous testons la configuration SMTP et IMAP.
Après avoir terminé l’installation et les tests finaux, veuillez supprimer tout le dossier d’installation du répertoire racine de votre installation RoundCube.

Enfin, changez la ligne 709 dans le fichier /program/include/main.inc comme décrit à l’étape 7 de ce comment faire.

Étape 9 – Accéder à votre nouveau client webmail :

Maintenant, vous pouvez vous diriger vers votre nouveau client webmail avec votre navigateur préféré. L’adresse selon mon comment faire est : http://webmail.myhostingcompany.tld

Vous pouvez vous connecter avec n’importe quelle combinaison nom d’utilisateur/mot de passe ou adresse email/mot de passe valide, comme défini dans ISPConfig.

Après votre première connexion, vous devez effectuer quelques réglages avant de commencer à utiliser RoundCube. Ici, la première chose que vous devez faire est de définir votre identité. Vous pouvez définir plus d’une identité pour une adresse email mais vous avez besoin d’au moins une. Lorsque vous créez une identité, changez également @localhost en @votredomaine.tld si nécessaire.

ÉTAPE 10 – Personnaliser RoundCube :

Si vous souhaitez personnaliser RoundCube webmail, je vous renvoie au comment faire de Paul Stamatiou à l’URL : http://paulstamatiou.com/2005/10/29/how-to-setup-roundcube-webmail-on-your-server/

Avant de commencer à personnaliser RoundCube, je recommande de le télécharger d’abord en utilisant votre compte administrateur comme mentionné à l’ÉTAPE 2. Personnaliser RoundCube webmail sur votre bureau local est plus confortable.

Informations :

Plus d’informations sur RoundCube : http://www.roundcube.net/

Remerciements spéciaux à :

Pauls Stamatiou, qui a écrit et publié un joli comment faire pour configurer RoundCube http://paulstamatiou.com/2005/10/29/how-to-setup-roundcube-webmail-on-your-server/

Les membres de Howtoforge pour leurs contributions utiles !