--- title: "Guide d’installation" description: "Installer Éclair CMS en 3 minutes : prérequis, téléchargement, envoi par FTP ou gestionnaire de fichiers, assistant en 4 étapes et premiers réglages." url: "https://eclaircms.org/installation" lang: "fr" author: "Thierry Gustin" published: "2026-10-30" updated: "2026-10-30" --- # Guide d’installation > **L’essentiel** — Pour installer Éclair CMS, il faut un hébergement avec PHP 8.1 ou plus (8.3 recommandé), Apache ou LiteSpeed et un certificat HTTPS. Télécharge l’archive de 402 Ko, envoie le contenu du dossier eclair dans le dossier public de ton site (fichiers .htaccess compris), ouvre l’adresse du site et réponds aux 4 questions de l’assistant, dans les 2 heures qui suivent ta première visite. Installer Éclair CMS prend environ 3 minutes : pas de base de données à créer, pas de fichier de configuration à remplir. Tu envoies un dossier sur ton hébergement, tu ouvres l’adresse de ton site, et un assistant te pose quatre questions. Ce guide détaille chaque étape, captures d’écran à l’appui, puis les réglages à faire juste après. > **Tu es chez o2switch ?** — Suis plutôt [le guide spécial o2switch](https://eclaircms.org/installation/o2switch) : il montre chaque menu de cPanel, du domaine au certificat HTTPS. Pour essayer Éclair sans hébergement, vois [l’installation sur ton ordinateur](https://eclaircms.org/installation/ordinateur). ## De quoi as-tu besoin pour installer Éclair CMS ? D’un hébergement web classique, comme un mutualisé à quelques euros par mois. Aucune base de données n’est nécessaire. | Élément | Minimum | Recommandé | | --- | --- | --- | | Version de PHP | 8.1 | 8.3 ou 8.4 | | Extensions PHP indispensables | `mbstring`, `json`, `dom`, `session` | présentes par défaut presque partout | | Extensions PHP conseillées | — | `gd` (images WebP), `zip` (sauvegardes), `curl` (IndexNow, assistant IA), `zlib` (administration traduite) | | Serveur web | Apache ou LiteSpeed avec `.htaccess` | idem, ou Nginx avec la [configuration fournie](https://eclaircms.org/documentation/developpeurs) | | Certificat HTTPS | conseillé | Let’s Encrypt, gratuit chez presque tous les hébergeurs | | Espace disque | 1 Mo pour Éclair | plus tes images | | Base de données | aucune | aucune | La quasi-totalité des hébergements mutualisés conviennent : o2switch, OVH, Hostinger, IONOS, PlanetHoster… Et pas d’inquiétude : l’assistant d’installation vérifie tout cela pour toi et explique quoi corriger. ## Étape 1 : télécharger Éclair Télécharge l’archive officielle, puis décompresse-la sur ton ordinateur (double-clic sur Mac, clic droit › Extraire tout sur Windows). [Télécharger Éclair 1.2.0 (402 Ko)](https://github.com/Jacckisback/eclair-cms/raw/main/dist/eclair-cms-1.2.0.zip) Tu obtiens un dossier `eclair` et trois fichiers texte (lisez-moi, licence MIT et mentions des tiers) qui n’ont pas besoin d’être envoyés. Voici ce que contient le dossier `eclair` : | Élément | Rôle | | --- | --- | | `index.php` | Le point d’entrée : il sert les pages en cache sans charger l’application | | `.htaccess` | Adresses propres, protections, compression et cache navigateur (fichier caché) | | `app/` | Le code d’Éclair, l’administration et le thème | | `assets/` | Le CSS et le JavaScript de l’administration, et le petit script du site | | `data/` | Tes contenus, réglages et comptes, créés à l’installation et jamais publics | | `cache/` | Les pages déjà générées | | `media/` | Tes images | | `eclair-config.exemple.php` | Un modèle de réglages avancés, facultatif | ## Étape 2 : envoyer les fichiers sur ton hébergement Le but : que `index.php`, `.htaccess` et les dossiers `app`, `assets`, `data`, `cache` et `media` se retrouvent **directement dans le dossier public de ton site**. Selon l’hébergeur, il s’appelle `public_html`, `www`, `htdocs` ou porte le nom de ton domaine. ### Avec le gestionnaire de fichiers de ton hébergeur C’est la méthode la plus simple, sans logiciel à installer : 1. Ouvre le gestionnaire de fichiers depuis l’espace client de ton hébergeur (dans cPanel : **Fichiers › Gestionnaire de fichiers**). 2. Va dans le dossier public de ton site et envoie l’archive `eclair-cms-1.2.0.zip`. 3. Fais un clic droit sur l’archive, puis **Extraire** : un dossier `eclair` apparaît. 4. Affiche les fichiers cachés (dans cPanel : **Paramètres › Afficher les fichiers masqués**), ouvre le dossier `eclair`, sélectionne **tout** son contenu, `.htaccess` compris, et déplace-le d’un niveau vers le haut, dans le dossier public. 5. Supprime le dossier `eclair` devenu vide et l’archive. ### Avec un logiciel FTP comme FileZilla 1. Récupère les identifiants FTP dans l’espace client de ton hébergeur : serveur, identifiant, mot de passe (et port 22 si l’hébergeur propose le SFTP, plus sûr). 2. Connecte-toi avec [FileZilla](https://filezilla-project.org/), gratuit, et ouvre le dossier public de ton site dans la colonne de droite. 3. Active **Serveur › Forcer l’affichage des fichiers cachés**, sinon le `.htaccess` risque de ne pas partir. 4. Dans la colonne de gauche, ouvre le dossier `eclair`, sélectionne tout son contenu et glisse-le à droite. > **N’oublie pas le fichier .htaccess** — Son nom commence par un point : il est caché par défaut. Sans lui, toutes les pages sauf l’accueil affichent une erreur 404. L’assistant te prévient s’il manque. ### Et dans un sous-dossier ou un sous-domaine ? Ça marche aussi. Pour un site à l’adresse `exemple.fr/site/`, envoie simplement les fichiers dans le dossier `site` : Éclair détecte tout seul le sous-dossier. Pour un sous-domaine comme `blog.exemple.fr`, envoie-les dans le dossier rattaché à ce sous-domaine. ## Étape 3 : répondre aux 4 questions de l’assistant Pour installer Éclair CMS, il ne reste qu’à ouvrir l’adresse de ton site dans ton navigateur : l’assistant d’installation démarre, en français ou dans l’une des 6 autres langues proposées en haut à droite. > **Une fenêtre de 2 heures** — Par sécurité, l’installation doit être terminée dans les 2 heures qui suivent la première visite : sinon, n’importe qui pourrait s’emparer d’un site déposé puis oublié. Passé ce délai, supprime le fichier `data/install-window.php` par FTP et recharge la page. ### Bienvenue : la vérification de ton hébergement L’assistant contrôle la version de PHP, les extensions, les droits d’écriture des dossiers, le HTTPS et la réécriture d’adresses. Si tout est vert, clique sur **C’est parti**. Si un point est rouge, il t’explique quoi corriger chez ton hébergeur. ![Assistant d’installation d’Éclair, écran de bienvenue : 14 points vérifiés, l’hébergement est prêt](https://eclaircms.org/media/2026/10/installateur-bienvenue.webp) *« 14 points vérifiés : ton hébergement est prêt ».* ### Question 1 : ton site Indique le **nom** de ton site, un **slogan** facultatif, sa **langue** et son **genre**. Tout se modifie plus tard. ![Assistant d’installation d’Éclair, étape Ton site : nom, slogan, langue et type de site](https://eclaircms.org/media/2026/10/installateur-site.webp) Le genre choisi détermine les premières pages créées pour toi : | Genre | Ce qu’Éclair crée | | --- | --- | | 🏢 Site vitrine | Accueil (bannière, atouts, derniers articles), Services avec FAQ, À propos, Contact, Blog et pages légales | | ✍️ Blog | Accueil avec les derniers articles, À propos, Contact, une catégorie « Guides » et pages légales | | 🧑‍💻 Freelance / portfolio | Accueil à ton nom, compétences, À propos, Blog, Contact et pages légales | | 🎯 Page unique | Une page de vente (bannière, atouts, FAQ, formulaire) et les pages légales, sans blog | ### Question 2 : ton compte Ton nom, ton e-mail et un mot de passe d’au moins 10 caractères. Les mots de passe trop courants sont refusés, et une jauge t’indique la solidité du tien. ![Assistant d’installation d’Éclair, étape Ton compte : nom, e-mail et mot de passe avec jauge de solidité](https://eclaircms.org/media/2026/10/installateur-compte.webp) > **Un mot de passe solide et facile à retenir** — Une phrase de quatre mots, comme `Lumière-sur-la-colline-2026`, est bien plus robuste qu’un mot court rempli de symboles. Enregistre-la dans ton gestionnaire de mots de passe. ### Question 3 : ta visibilité - **Google et Bing peuvent indexer mon site** : décoche si tu préfères construire ton site tranquillement avant de le montrer. - **Les intelligences artificielles** : *Bienvenue* (elles peuvent lire et citer ton site, recommandé), *Citations seulement* (elles te citent sans entraîner leurs modèles avec tes textes) ou *Non merci*. - **L’adresse de ton administration** : remplace `admin` par un mot à toi, ou clique sur **Générer une adresse secrète**. Une adresse personnelle éloigne les robots pirates. ![Assistant d’installation d’Éclair, étape Visibilité : indexation Google et Bing, robots d’IA et adresse de l’administration](https://eclaircms.org/media/2026/10/installateur-visibilite.webp) ### Question 4 : le récapitulatif Relis tes choix, puis clique sur **Créer mon site ⚡**. Éclair crée tes pages, un article d’exemple, ton compte, le sitemap et les icônes du site. ![Assistant d’installation d’Éclair, récapitulatif avant de créer le site](https://eclaircms.org/media/2026/10/installateur-recapitulatif.webp) ### C’est en ligne ! Des confettis, et ton site est publié. **Note bien l’adresse de ton administration** (par exemple `https://ton-site.fr/atelier`) et ajoute-la à tes favoris : c’est là que tu te connecteras désormais. ![Fin de l’installation d’Éclair : Ton site est en ligne, avec l’adresse de l’administration à garder en favori](https://eclaircms.org/media/2026/10/installateur-termine.webp) ## Étape 4 : tes premiers réglages en 10 minutes Le tableau de bord t’accueille avec une liste **Premiers pas** : chaque ligne t’emmène au bon écran. ![Tableau de bord d’Éclair juste après l’installation, avec la liste Premiers pas](https://eclaircms.org/media/2026/10/tableau-de-bord-premiers-pas.webp) 1. **Ajoute ton logo et ta couleur** (Réglages › Apparence) : le contraste des couleurs reste lisible automatiquement. 2. **Personnalise la page d’accueil** : remplace les textes d’exemple par ta propre offre. 3. **Écris ton premier article**, en t’aidant des notes SEO et GEO de l’éditeur. 4. **Complète ton profil d’auteur** : photo, fonction et biographie renforcent la confiance de Google et des IA. 5. **Active la double authentification** (Mon profil › Double authentification). 6. **Complète les mentions légales**, obligatoires en France comme en Espagne. 7. **Relie ton site à Google Search Console** (Réglages › SEO) : colle la balise de vérification, Éclair extrait le code. Ajoute une huitième étape : dans **Sécurité**, clique sur **Vérifier l’adresse du site**. Une fois l’adresse confirmée, Éclair redirige les visiteurs vers l’adresse officielle (avec ou sans www) et impose le HTTPS. ![Page Sécurité de l’administration d’Éclair : niveau de protection, test des dossiers et contrôle d’intégrité](https://eclaircms.org/media/2026/10/page-securite.webp) *La page Sécurité : niveau de protection, test des dossiers protégés et contrôle d’intégrité des fichiers.* Le détail de chaque réglage est dans [Premiers pas après l’installation](https://eclaircms.org/documentation/premiers-pas). ## Que faire si l’installation ne démarre pas ? | Ce que tu vois | Solution | | --- | --- | | « Éclair a besoin de PHP 8.1 ou plus récent » | Change la version de PHP dans l’espace client de ton hébergeur, puis recharge la page | | Erreur 404 sur toutes les pages sauf l’accueil | Le `.htaccess` n’a pas été envoyé : affiche les fichiers cachés et renvoie-le | | Erreur 500 juste après l’envoi | Une directive du `.htaccess` est refusée : contacte ton hébergeur ([détails](https://eclaircms.org/documentation/depannage#erreur-500)) | | « Installation verrouillée » | La fenêtre de 2 heures est passée : supprime `data/install-window.php` et recharge | | Un dossier « non accessible en écriture » | Donne les droits 755 aux dossiers `data`, `cache` et `media` avec ton logiciel FTP | Pour tout le reste, consulte [le guide de dépannage](https://eclaircms.org/documentation/depannage) ou [écris-moi](https://eclaircms.org/contact). ## Questions sur l’installation ### Combien de temps faut-il pour installer Éclair ? Environ 3 minutes : le temps d’envoyer moins de 1 Mo de fichiers et de répondre aux 4 questions de l’assistant. Compte quelques minutes de plus si tu dois d’abord activer le certificat HTTPS ou changer la version de PHP. ### Faut-il créer une base de données pour installer Éclair CMS ? Non. Éclair n’utilise aucune base de données : tes contenus sont des fichiers protégés dans le dossier `data`. Tu n’as ni base à créer, ni identifiants MySQL à saisir. ### Puis-je installer Éclair sur un hébergement qui contient déjà un site ? Oui, dans un sous-dossier (par exemple `exemple.fr/nouveau/`) ou sur un sous-domaine. Éclair détecte automatiquement le dossier dans lequel il est installé. ### Puis-je essayer Éclair avant de le mettre en ligne ? Oui : installe-le sur ton ordinateur avec un serveur local, en suivant [l’installation sur ton ordinateur](https://eclaircms.org/installation/ordinateur). Tu pourras ensuite déplacer tout le dossier chez ton hébergeur. ### Comment désinstaller Éclair ? Supprime ses fichiers et ses dossiers : comme il n’y a pas de base de données, rien d’autre ne reste sur ton hébergement. Pense d’abord à télécharger une sauvegarde depuis la page Sécurité si tu veux garder tes contenus. [Installer Éclair sur o2switch, pas à pas](https://eclaircms.org/installation/o2switch)