---
title: "Dépannage"
description: "Dépannage Éclair CMS : mot de passe oublié, installation verrouillée, erreur 404 ou 500, images non converties, e-mails absents, mode débogage, proxy."
url: "https://eclaircms.org/documentation/depannage"
lang: "fr"
author: "Thierry Gustin"
published: "2026-10-30"
updated: "2026-10-30"
---

# Dépannage

> **L’essentiel** — Ce guide de dépannage Éclair CMS donne la solution des problèmes les plus fréquents : mot de passe oublié ou téléphone 2FA perdu (fichier data/reset.php), installation verrouillée après 2 heures, erreur 404 due à un .htaccess absent, erreur 500, images non converties en WebP, e-mails du formulaire non reçus, mode débogage et adresse IP faussée par un proxy.

Ce guide de dépannage Éclair CMS rassemble les problèmes les plus fréquents et leur solution, du mot de passe oublié à l’erreur 404. Chaque section correspond à un message ou à un symptôme précis : utilise le sommaire pour aller droit au tien. La plupart se règlent en deux minutes, avec ton logiciel FTP ou le gestionnaire de fichiers de ton hébergeur.

## Mot de passe oublié ou téléphone de double authentification perdu ?

Commence par les solutions les plus simples :

- **Un autre administrateur existe** : dans Utilisateurs, il peut cliquer sur **Réinitialiser le mot de passe** (un mot de passe provisoire est créé) ou sur **Désactiver la 2FA** de ton compte.
- **Tu as perdu ton téléphone, pas tes codes** : connecte-toi avec l’un de tes 8 codes de secours à la place du code à 6 chiffres.

Si tu es le seul administrateur, utilise le secours par FTP. Crée un fichier `data/reset.php` contenant exactement ces trois lignes :

```text
<?php exit; ?>
ton-adresse@email.fr
TonNouveauMotDePasse2026
```

Dans les 24 heures, **connecte-toi avec cet e-mail et ce nouveau mot de passe**. Le mot de passe est remplacé, la double authentification de ce compte est désactivée, tes autres sessions sont fermées et le fichier est supprimé automatiquement.

> **Pourquoi c’est sûr** — Personne d’autre ne peut déclencher ce secours : il faut un accès FTP pour déposer le fichier, et connaître son contenu pour l’utiliser. Un fichier sans la première ligne est refusé et supprimé. Le nouveau mot de passe doit respecter les règles habituelles : 10 caractères minimum, pas de mot de passe trop courant.

## « Installation verrouillée » : que faire ?

Par sécurité, l’installation doit être faite 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, puis recharge la page : une nouvelle fenêtre de 2 heures s’ouvre.

## Que signifie « Adresse non vérifiée » dans la page Sécurité ?

Ton serveur n’arrive pas à s’appeler lui-même sur l’adresse du site : pare-feu de l’hébergeur, DNS pas encore propagé, domaine en cours de transfert… Le site fonctionne normalement, mais sans redirection vers l’adresse officielle (avec ou sans www, http vers https). Clique sur **Vérifier l’adresse du site** une fois le domaine en place.

## Pourquoi une erreur 404 sur toutes les pages sauf l’accueil ?

Le fichier `.htaccess` n’a pas été envoyé, car c’est un fichier caché, ou la réécriture d’URL est désactivée. Active « Afficher les fichiers cachés » dans ton logiciel FTP et renvoie-le à la racine du site. Si ton hébergeur l’exige, décommente la ligne `RewriteBase /` du `.htaccess`.

> **Le diagnostic de l’installateur** — Pendant l’installation, la ligne « Adresses propres (réécriture d’URL) » indique déjà si le `.htaccess` fonctionne. Sur Nginx, qui ignore ce fichier, copie la configuration du guide [Pour les développeurs](https://eclaircms.org/documentation/developpeurs).

## Que faire en cas d’erreur 500 juste après l’envoi ?

Une directive du `.htaccess` est refusée par ton hébergeur. C’est très rare : seules des directives tolérées sur les hébergements mutualisés sont utilisées. Supprime le bloc concerné ou contacte ton hébergeur. Si la page « Oups, un court-circuit » s’affiche avec une référence, le détail de l’erreur se trouve dans **Sécurité › Dernières erreurs techniques**.

## Pourquoi les images ne sont-elles pas converties en WebP ?

L’extension PHP GD, ou son support du WebP, manque sur ton hébergement. Active-la dans le panneau PHP de ton hébergeur. En attendant, tes images restent en JPG ou en PNG : le site fonctionne, il est juste un peu moins léger.

## Pourquoi je ne reçois pas les e-mails du formulaire ?

Pas de panique : les messages sont aussi enregistrés dans l’administration, menu **Messages**. Vérifie ensuite l’adresse de réception dans **Réglages › Contact** ; par défaut, c’est l’e-mail du premier administrateur. Certains hébergeurs exigent que l’expéditeur appartienne au domaine du site : crée une adresse e-mail sur ton domaine si besoin.

## Comment activer le mode débogage ?

Crée un fichier `eclair-config.php` à la racine du site, à côté de `index.php`, sur le modèle de `eclair-config.exemple.php` :

```php
<?php
defined('ECLAIR') || exit;

// Afficher le détail des erreurs, le temps de résoudre le problème.
define('ECLAIR_DEBUG', true);
```

Les erreurs s’affichent alors en détail et le cache statique est désactivé. **Supprime ce fichier dès que le problème est réglé** : le détail des erreurs n’a pas à être visible de tous.

## Toutes les adresses IP sont identiques : ton site est-il derrière un proxy ?

Si le journal de sécurité affiche la même adresse IP pour tous les visiteurs, ton site est probablement servi derrière un proxy ou un CDN, comme Cloudflare. Les limites de tentatives, qui s’appliquent par réseau, concernent alors tout le monde à la fois. Dans **Réglages › Avancé › « Site derrière un proxy / CDN »**, choisis l’en-tête qui transmet la vraie adresse : `CF-Connecting-IP` pour Cloudflare, `X-Forwarded-For` ou `X-Real-IP` selon ton hébergeur.

> **Seulement si c’est nécessaire** — Laisse « Non (recommandé) » si ton site n’est pas derrière un proxy : un visiteur pourrait sinon fournir une fausse adresse IP. Éclair ne lit que la dernière adresse de l’en-tête, celle ajoutée par le proxy.

## « Éclair a besoin de PHP 8.1 ou plus récent » : que faire ?

Ton hébergement utilise une version de PHP trop ancienne. Change-la dans l’espace client de ton hébergeur, souvent en un clic, puis recharge la page. Éclair fonctionne de PHP 8.1 à 8.5 ; choisis 8.3 ou plus récent si possible. Le guide [Installer Éclair sur o2switch](https://eclaircms.org/installation/o2switch) montre où se trouve ce réglage dans cPanel.

## L’assistant IA ne répond pas ?

Clé refusée, crédit épuisé, budget du mois atteint, connexions sortantes bloquées : chaque message a sa solution dans le guide de [l’assistant IA](https://eclaircms.org/documentation/assistant-ia#que-faire-si-l-assistant-ne-repond-pas).

## Ton problème n’est pas dans ce guide de dépannage Éclair CMS ?

Note le message d’erreur exact, ton hébergeur et ta version de PHP, puis écris-moi via la page [Contact](https://eclaircms.org/contact). Tu peux aussi signaler un problème sur [GitHub](https://github.com/Jacckisback/eclair-cms/issues) : sa solution viendra enrichir ce dépannage Éclair CMS pour tous les utilisateurs.

## Questions de dépannage

### Le fichier data/reset.php fonctionne-t-il si j’ai activé la double authentification ?

Oui. La connexion avec l’e-mail et le nouveau mot de passe du fichier désactive la double authentification de ce compte. Réactive-la ensuite dans Mon profil.

### Où trouver les fichiers cachés comme .htaccess ?

Dans ton logiciel FTP, active l’option « Afficher les fichiers cachés ». Dans le gestionnaire de fichiers de cPanel, c’est dans Paramètres › « Afficher les fichiers masqués ».

### Comment savoir quelle erreur s’est produite ?

Ouvre Sécurité › Dernières erreurs techniques, ou active temporairement le mode débogage avec un fichier eclair-config.php. Pense à le supprimer ensuite.

### Mon site affiche une page blanche : par où commencer ?

Vérifie la version de PHP (8.1 minimum), puis active le mode débogage pour afficher l’erreur. Dans la plupart des cas, il manque un fichier ou une extension PHP.