Tutoriel d'installation de RoundCube 0.6 sur Gandi Simple Hosting

RoundCube est un webmail puissant et simple d'utilisation comportant de nombreuses options. Si vous souhaitez avoir votre Webmail rien que pour vous (et votre famille, vos employés etc…), vous pouvez l'installer sur une instance Simple Gandi.

La première étape va consister à aller télécharger l'archive compressée de RoundCube (Stable 0.6) pour ce tutoriel.
Une fois l'archive sur votre disque dur, décompressez celle-ci puis transférez l'intégralité du contenu du répertoire (et non le répertoire lui-même) dans le répertoire cible de votre instance.
Ex.: Si vous souhaitez que votre webmail soit accessible à partir de webmail.mondomaine.com, il vous faut alors déposer les fichiers et dossiers dans le virtual host ”webmail.mondomaine.com” de votre instance.

Nous allons ensuite changer temporairement les permissions d'accès sur deux des répertoires que vous venez de transférer. Veuillez donc passer les répertoires /temp et /logs en niveau de droits 777 (au lieu de 755 par défaut).

Si vous ne savez pas comment changer les permissions sur un fichier, veuillez lire cette page de notre Wiki

Une fois ceci réalisé, veuillez vous rendre, via votre navigateur, dans le répertoire /installer de l'endroit où vous avez transféré vos fichiers.
Ex.: si vous avez transféré les fichiers de votre RoundCube dans le virtual host ”webmail.mondomaine.com”, alors il vous faut taper dans votre navigateur http://webmail.mondomaine.com/installer/

A partir de cette page, nous allons pouvoir gérer la suite de l'installation de RoundCube sur votre instance PHP/MySQL.

La première page de cette installation va aller valider les prérequis nécessaires à l'installation de RoundCube.

Edit : si vous rencontrez un probleme de “date.timezone: NOT OK(empty value detected)” veuillez ajouter la valeur : date.timezone = “Europe/Paris” dans votre custom php.ini http://wiki.gandi.net/fr/simple/php/phpini

La page de configuration de RoundCube est longue comme un jour sans pain :)
Beaucoup d'éléments de la configuration sont propres à un Webmail, et nous assumons que vous savez comment régler le votre.
Toutefois, voici quelques informations propres à Gandi Simple Hosting :
Database Setup
Database server : Laissez la valeur localhost
Database name : mettez le nom de la base que vous souhaitez utiliser.
Database user name : Par défaut, l'utilisateur est root, sauf si vous en avez créé un possédant le niveau de droit requis

Si vous ne savez pas comment créer une nouvelle base de données, merci de lire cette page wiki à propos de l'utilisation de PHPmyAdmin.

IMAP Settings
Nous considérons, dans les exemples de réglages suivants, que votre nom de domaine est chez Gandi et que le service Mail est activé.
default_host : mail.gandi.net
username_domain : vous devez laisser vide si vous avez plusieurs utilisateurs qui utiliseront le webmail. Sinon, vous pouvez entrer l'utilisateur que vous souhaitez voir renseigné par défaut (couple user@domain surtout)

SMTP Settings
smtp_server : laissez vide, le sendmail() de php travaille pour vous :)

Si vous souhaitez que la langue par défaut de votre Webmail soit le français, entrez alors la valeur fr_FR dans le champ language de la section Display settings & user prefs

Une fois la configuration terminée, vous verrez s'afficher une page contenant 2 fenêtres contenant votre configuration au format php.
A ce stade, vous avez deux possibilités :

  • Copier l'intégralité de chaque fenêtre et le coller dans un nouveau document que vous nommerez comme l'intitulé de la fenêtre (à savoir main.inc.php pour le premier et db.inc.php)
  • Télécharger chaque fichier grâce au lien download en haut de chaque fenêtre

Quel que soit la méthode choisie, il vous faudra ensuite transférer ces fichiers sur votre instance via votre sFTP, dans le répertoire /config/ de votre webmail.

Veuillez noter que ces 2 fichiers de configuration sont sensibles : s'ils sont lus en clair (non parsé) comme vous pouvez le faire à ce stade, il est possible de trouver différents mots de passe. Il est donc fortement conseiller de détruire ces fichiers en local, une fois le transfert effectué.

Vous devez cliquer sur le bouton CONTINUE uniquement lorsque le transfert des fichiers est terminé. Vous devriez alors voir une page comportant plusieurs jolis OK en vert, et tout de même un NOT OK en rouge.
Aucune crainte, c'est votre base qui ne contient pas encore les tables. Il vous suffit de cliquer sur initialize database pour créer ceux-ci. Quelques secondes plus tard, votre page est pleine de OK tous vert :)

Vous pouvez ensuite, sur cette même page, tester vos configurations.
Pour tester le SMTP, c'est à dire l'envoi de mail à partir de votre serveur, rien de plus simple : entrez l'adresse email que vous utilisez pour le webmail en tant que Sender puis entrez en tant que Recipient l'adresse du destinataire de test (autant que vous puissiez consulter cette adresse pour valider votre test ;))

Pour tester l'IMAP, c'est à dire la consultation de ses mails à distance, réglez le serveur sur la valeur choisie par défaut (vous pouvez en avoir plusieurs), puis entrez l'adresse email complète de l'utilisateur et enfin le mot de passe associé.

La configuration et l'installation de votre RoundCube est terminée.
Une fois que vous avez vérifié que votre Webmail fonctionne correctement, vous reste une chose importante à faire : supprimer le répertoire /installer/ de votre instance, pour des raisons de sécurité.

Dernière modification: le 12/12/2012 à 10:25 par Norman B. (Gandi)