Grâce à l’utilisation des dépôts et au package de Web Wack Creations (http://bugs.web-wack.at/), il est possible d’installer Roundcube en quelques clics comme webmail via ISPConfig. L’avantage de cette intégration est double car en plus de simplifier l’installation, le package met automatiquement en place les liens nécessaires pour permettre aux utilisateurs de Roundcube de gérer leurs paramètres tels que le filtrage de mails, le répondeur automatique etc.
Utilisation des dépôts
L’installation de Roundcube va se faire par l’intermédiaire des dépôts. Dans l’onglet Système sélectionnez Dépôt dans la section Applications & Plugins.
ISPConfig 3, dépôts
Sélection du dépot
Sélectionner Ajouter une entrée dans la fenêtre de sélection entrée le nom et l’url du dépôt. (Laisser les cases Utilisateur et Mot de passe vides.)
Nom: web wack creations
url: http://repo.web-wack.at/ispconfig3/
N’oubliez pas de cochez la case Actif puis enregistrez.
Mise à jour des paquets
Sélectionnez à présent paquets dans le menu à gauche puis choisissez update package list afin de mettre à jour la liste des paquets (avec le nouveau dépôt que l’on a sélectionné à l’étape précédente.) Vous devriez voir apparaître un nouveau paquet à savoir Roundcube.
ISPConfig 3, paquets
Installation Roundcube
L’installation de Roundcube à partir de ce point est on ne peut plus simple: Cliquez sur Install Now puis cliquez sur next.
Et c’est tout, en deux clics vous avez installé votre accès webmail. Il est dès à présent accessible via l’interface suivante : http://votreserver.com:8081/roundcube/
Il reste toutefois quelques petites modifications à faire afin de le rendre complètement fonctionnel. La première modification à faire est la configuration du serveur:
Il vous faudra pour cela vous connecter en ssh à votre serveur. (oui on n’y échappe rarement très longtemps…)
|
1 |
vi /var/www/apps/roundcube/config/main.inc.php |
Modifier la ligne suivante:
|
1 |
$rcmail_config['default_host'] = 'localhost'; |
Remarque : Si vous souhaitez utiliser plusieurs noms de domaines simultanément, il est préférable de laisser cette ligne de configuration inchangée, à savoir : $rcmail_config[‘default_host’] = »;
De cette façon, roundcube choisira automatiquement le bon serveur selon l’adresse mail entrée par l’utilisateur.
Ceci permet de spécifier à Roundcube le serveur à utiliser par défaut lors de la connexion d’un utilisateur. (Vous pourriez spécifier un serveur distant si tel était le cas mais nous resterons dans le cas d’utilisation classique.)
Enfin, si vous avez forcé l’utilisation de https pour l’interface admin ISPConfig, une dernière modification est à effectuer, à savoir modifier le fichier config.inc.php de roundcube.
|
1 |
vi /var/www/apps/roundcube/plugins/ispconfig3_account/config/config.inc.php |
Changer le port si nécessaire (8080 par défaut, il doit correspondre au port utiliser pour accéder à votre interface d’administration ISPConfig) et spécifiez https:// à la place du http:// sur la ligne de configuration $rcmail_config[‘soap_url’]
|
1 |
$rcmail_config['soap_url'] = 'https://votreserveur.com:8080/remote/'; |
Desactivation de suhosin
Il est également important de désactiver suhosin pour que Roundcube puisse fonctionner correctement. Si tel n’est pas le cas, vous verrez probablement apparaître l’erreur suivante:
ERROR: Wrong ‘suhosin.session.encrypt’ option value. Read REQUIREMENTS section in INSTALL file or use Roundcube Installer, please!
Pour résoudre le problème, il vous faut désactiver suhosin dans apache.
|
1 |
vi /etc/php5/apache2/php.ini |
Ajouter les lignes suivantes à la fin du fichier php.ini
|
1 2 |
[suhosin] suhosin.session.encrypt = Off |
N’oubliez pas de redémarrer apache.
|
1 |
/etc/init.d/apache2 restart |
Redirection
Votre webmail est à présent disponible et fonctionnel. Toutefois, vous pouvez juger utile de mettre en place une redirection afin de simplifier l’adresse d’accès au webmail. Pour cela, il existe deux solutions.
Redirection simple
Il s’agit de la façon la plus simple de faire. Toutefois, elle présente l’inconvénient de rediriger l’utilisateur vers la première url de façon non transparente. Dans l’onglet Sites, sélectionner le site web sur lequel vous souhaitez faire la redirection puis l’onglet Options. Vous devrez ensuite ajouter dans le cadre directives apache:
|
1 |
RedirectPermanent /webmail "http://votreserver.com:8081/roundcube/" |
Redirection transparente
Pour effectuer une redirection transparente pour l’utilisateur. (Il ne verra donc plus que l’url qu’il aura entré en premier lieu) il vous faut tout d’abord vous assurer de l’activation de mod_proxy sur votre serveur. Via une console en ssh activez mod_proxy
|
1 |
a2enmod proxy a2enmod proxy_http |
Si celui-ci était déjà activé, un message vous le fera savoir. Autrement n’oubliez pas de redémarrer votre serveur apache.
|
1 |
/etc/init.d/apache2 restart |
Après cela il vous suffit d’ajouter dans les directives apaches du site de votre choix (cf. paragraphe sur la redirection simple)
|
1 2 3 |
# Redirection /webmail pour sur le port Roundcube ProxyPass /webmail http://localhost:8081/roundcube ProxyPassReverse /webmail http://localhost:8081/roundcube |
Vous avez ainsi accès à votre webmail via l’adresse suivante: http://site_web_selectionné/webmail
Interface Roundcube
Pour vous connecter au webmail, il vous faudra avoir au préalable créé votre boite mail. Je vous invite pour cela à suivre la section correspondante sur le tutoriel ISPConfig 3, premiers pas. Enfin, en cas de soucis n’hésitez pas à faire part de vos questions en commentaire, je serais ravi de vous aider. Un tutoriel suivra sur la personnalisation de Roundcube (tel que l’ajout de menu contextuels ou d’autres plugins divers.)
