L'installation se déroule en deux étapes : le téléchargement des fichiers dans votre espace d'hébergement d'abord puis le lancement de l'installation proprement dite. Mais avant cela, assurez-vous que votre hébergement dispose bien des prérequis.

Dotclear 1.2 fonctionne sur les hébergements supportant PHP 4.1 minimum et MySQL 3.23 minimum (liste d'hébergements testés dans la section Hébergement)

• Le module XML de PHP doit être présent.
• Le support de sessions doit être activé.
• Le navigateur servant à l'installation doit être configuré pour accepter les cookies de session.

Au démarrage de la procédure d'installation, Dotclear vérifiera que ces conditions sont bien remplies.

Dotclear propose un système d'installation simplifié via un installeur qui se chargera de récuperer tous les fichiers nécessaires à l'installation.

• Connectez vous en FTP sur votre serveur (voir plus bas pour savoir comment faire).
• Créez un répertoire vide (par exemple dotclear ou blog).
• Téléchargez le fichier http://download.dotclear.net/misc/dc_loader-1.2.php puis déposez-le dans le répertoire précédemment créé.
• Rendez-vous sur ce fichier avec votre navigateur (par exemple www.mon_site/dotclear/dc_loader-1.2.php).
• Laissez location à sa valeur par défaut (/) et cliquez sur continue.

Si tout se passe bien, vous devrez patienter quelques instants et serez dirigé vers l'écran d'installation de Dotclear.

Si cette procédure échoue, suivez les instructions de transfert des fichiers sur votre serveur.

Téléchargez Dotclear sur votre disque dur (choisissez le format de compression zip ou tar.gz en fonction de l'application de compression dont vous disposez - zip par défaut pour les utilisateurs de Windows XP, tar.gz pour les utilisateurs Mac OSX). Vous devez décompresser localement l'archive (par exemple dans un répertoire nommé dotclear) avant de transférer son contenu sur votre serveur.

Pour transférer le contenu décompressé de l'archive, vous pouvez utiliser n'importe quel client FTP, par exemple FileZilla pour Windows ou RBrowser Lite pour Mac. Reportez-vous à la documentation fournie par votre hébergement pour connaître :

• Le nom du serveur FTP (aussi appelé nom d'hôte) ;
• Votre nom d'utilisateur (aussi appelé identifiant ou login) ;
• Votre mot de passe.

Déposez le répertoire de Dotclear dans votre espace web.

Une fois les fichiers de Dotclear installés sur le serveur, allez à l'adresse :
http://www.mon_site/dotclear/install/

L'assistant d'installation vous demande de choisir une langue et un encodage pour vos caractères.

Un ensemble de vérifications est effectué afin de déterminer si Dotclear peut être installé sur votre serveur. Si un des points de la configuration PHP ne passe pas, contactez votre administrateur ou votre prestataire d'hébergement.

Si le répertoire conf n'est pas accessible en écriture, vous devrez donner les droits adéquats avec votre client FTP. Voir plus bas (changer les droits des fichiers et répertoires) pour la démarche à suivre.

Vous devrez indiquer, et donc posséder, les informations suivantes :

• le nom de la machine hébergeant la base MySQL (consultez votre hébergeur).
• votre nom d'utilisateur pour se connecter à MySQL (généralement votre login).
• votre mot de passe pour se connecter à MySQL.
• le nom de la base de données qui sera exploitée par DotClear.
• laissez le préfixe à sa valeur par défaut si vous ne savez pas de quoi il s'agit.

Conservez ces informations quelque part, vous en aurez besoin lors des mises à jour de Dotclear.

Cliquez sur Créer les tables, un écran récapitule alors le bon déroulement de l'opération.

Le premier utilisateur que vous allez créer sera administrateur. Vous devez fournir obligatoirement un nom, un identifiant (qui servira à vous connecter) et un mot de passe¹⁾. Ne les oubliez pas !

Laissez l'emplacement de Dotclear à sa valeur par défaut à moins de bien savoir ce que vous faites. Donnez ensuite un nom à votre weblogue.

Vous devrez enfin choisir entre deux formats d'URL. Le format Query String donne des URLs de la forme www.mon_site/dotclear/index.php?2002/04, alors que le format Path Info donne des URLs de la forme www.mon_site/index.php/2002/04.

Vous pourrez changer le format d'URL de votre weblogue avec l'outil de configuration de DotClear si jamais vous vous êtes trompé.

Après avoir configuré votre weblogue, l'installation se termine par la création d'un premier billet.

Il ne vous reste plus qu'à cliquer sur Administrer votre weblogue pour passer aux choses sérieuses.

Vous serez alors automatiquement connecté à l'interface d'administration de votre weblogue. Retenez son adresse (www.mon_site/dotclear/ecrire/ par exemple) qui sera celle où vous vous connecterez par la suite pour administrer ou publier sur votre weblogue.

En allant à l'adresse de votre blogue (www.mon_site/dotclear/), vous constaterez qu'une première catégorie Général aura été créée, ainsi qu'un premier billet.

Votre weblogue est ouvert, félicitations ! Si vous avez des questions, des soucis d'installation, des astuces à partager, rendez-vous sur le forum pour entrer en contact avec les autres utilisateurs.