--- title: "Fehlerbehebung" description: "Éclair CMS Fehlerbehebung: Passwort vergessen, Installation gesperrt, Fehler 404 oder 500, nicht umgewandelte Bilder, fehlende E-Mails, Debug-Modus, Proxy." url: "https://eclaircms.org/de/dokumentation/fehlerbehebung" lang: "de" author: "Thierry Gustin" published: "2026-10-30" updated: "2026-11-01" --- # Fehlerbehebung > **Das Wichtigste** — Diese Éclair CMS Fehlerbehebung liefert die Lösung für die häufigsten Probleme: vergessenes Passwort oder verlorenes 2FA-Smartphone (Datei data/reset.php), nach 2 Stunden gesperrte Installation, Fehler 404 durch eine fehlende .htaccess, Fehler 500, nicht in WebP umgewandelte Bilder, nicht empfangene E-Mails des Formulars, Debug-Modus und durch einen Proxy verfälschte IP-Adressen. Diese Éclair CMS Fehlerbehebung bündelt die häufigsten Probleme und ihre Lösungen, vom vergessenen Passwort bis zum 404-Fehler. Jeder Abschnitt entspricht einer bestimmten Meldung oder einem bestimmten Symptom: Nutze das Inhaltsverzeichnis, um direkt zu deinem zu springen. Die meisten lassen sich in zwei Minuten beheben, mit deinem FTP-Programm oder dem Dateimanager deines Hosters. ## Passwort vergessen oder Smartphone mit Zwei-Faktor-Authentifizierung verloren? Beginne mit den einfachsten Lösungen: - **Es gibt einen anderen Administrator**: Unter Benutzer kann er auf **Passwort zurücksetzen** klicken (es wird ein temporäres Passwort erstellt) oder bei deinem Konto auf **2FA deaktivieren**. - **Du hast dein Smartphone verloren, nicht deine Codes**: Melde dich mit einem deiner 8 Backup-Codes statt mit dem 6-stelligen Code an. Bist du der einzige Administrator, nutze die Notfalllösung per FTP. Lege eine Datei `data/reset.php` an, die genau diese drei Zeilen enthält: ```text deine-adresse@beispiel.de DeinNeuesPasswort2026 ``` Melde dich innerhalb von 24 Stunden **mit dieser E-Mail-Adresse und diesem neuen Passwort an**. Das Passwort wird ersetzt, die Zwei-Faktor-Authentifizierung dieses Kontos wird deaktiviert, deine anderen Sitzungen werden beendet, und die Datei wird automatisch gelöscht. > **Warum das sicher ist** — Niemand sonst kann diese Notfalllösung auslösen: Man braucht FTP-Zugang, um die Datei abzulegen, und muss ihren Inhalt kennen, um sie zu nutzen. Eine Datei ohne die erste Zeile wird abgelehnt und gelöscht. Das neue Passwort muss die üblichen Regeln erfüllen: mindestens 10 Zeichen, kein allzu gängiges Passwort. ## „Installation gesperrt“: Was tun? Aus Sicherheitsgründen muss die Installation innerhalb von **2 Stunden** nach dem ersten Aufruf abgeschlossen werden: Sonst könnte jeder eine hochgeladene und dann vergessene Website übernehmen. Ist diese Frist abgelaufen, lösche die Datei `data/install-window.php` per FTP und lade die Seite neu: Ein neues Zeitfenster von 2 Stunden öffnet sich. ## Die Adresse der Website ist auf der Seite Sicherheit nicht verifiziert: Was bedeutet das? Dein Server kann sich unter der Adresse der Website nicht selbst aufrufen: Firewall des Hosters, DNS noch nicht verbreitet, Domain im Umzug … Die Website funktioniert normal, aber ohne Weiterleitung auf die offizielle Adresse (mit oder ohne www, http auf https). Klicke auf **Adresse der Website verifizieren**, sobald die Domain eingerichtet ist. ## Warum Fehler 404 auf allen Seiten außer der Startseite? Die Datei `.htaccess` wurde nicht hochgeladen, weil sie eine versteckte Datei ist, oder das URL-Rewriting ist deaktiviert. Aktiviere in deinem FTP-Programm „Versteckte Dateien anzeigen“ und lade sie erneut in das Stammverzeichnis der Website hoch. Verlangt dein Hoster es, entferne das Kommentarzeichen vor der Zeile `RewriteBase /` in der `.htaccess`. > **Die Diagnose des Installationsassistenten** — Bei der Installation zeigt die Zeile „Saubere Adressen (URL-Rewriting)“ bereits an, ob die `.htaccess` funktioniert. Bei Nginx, das diese Datei ignoriert, übernimm die Konfiguration aus dem Leitfaden [Für Entwickler](https://eclaircms.org/de/dokumentation/entwickler). ## Was tun bei einem Fehler 500 direkt nach dem Hochladen? Dein Hoster lehnt eine Direktive der `.htaccess` ab. Das ist sehr selten: Es werden nur Direktiven verwendet, die auf Shared Hosting zulässig sind. Entferne den betreffenden Block oder wende dich an deinen Hoster. Erscheint die Seite „Oups, un court-circuit.“ (französisch für „Hoppla, ein Kurzschluss.“) mit einer Referenz, stehen die Fehlerdetails unter **Sicherheit › Letzte technische Fehler**. ## Warum werden Bilder nicht in WebP umgewandelt? Auf deinem Hosting fehlt die PHP-Erweiterung GD oder ihre WebP-Unterstützung. Aktiviere sie in den PHP-Einstellungen deines Hosters. Bis dahin bleiben deine Bilder im JPG- oder PNG-Format: Die Website funktioniert, sie ist nur etwas weniger leicht. ## Warum bekomme ich die E-Mails des Kontaktformulars nicht? Keine Panik: Die Nachrichten werden auch im Adminbereich gespeichert, im Menü **Nachrichten**. Prüfe dann in **Einstellungen › Kontakt** die Adresse bei „Nachrichten empfangen unter“; standardmäßig ist es die E-Mail-Adresse des ersten Administrators. Manche Hoster verlangen, dass der Absender zur Domain der Website gehört: Lege bei Bedarf eine E-Mail-Adresse auf deiner Domain an. ## Wie aktivierst du den Debug-Modus? Lege im Stammverzeichnis der Website, neben `index.php`, eine Datei `eclair-config.php` an, nach dem Vorbild von `eclair-config.exemple.php`: ```php **Nur wenn nötig** — Lass „Nein (empfohlen)“ stehen, wenn deine Website nicht hinter einem Proxy liegt: Sonst könnte ein Besucher eine falsche IP-Adresse angeben. Éclair liest nur die letzte Adresse im Header, die vom Proxy hinzugefügte. ## „Éclair a besoin de PHP 8.1 ou plus récent“: Was tun? Diese Meldung erscheint immer auf Französisch und bedeutet: „Éclair braucht PHP 8.1 oder neuer“. Dein Hosting nutzt eine zu alte PHP-Version. Ändere sie im Kundenbereich deines Hosters, oft mit einem Klick, und lade die Seite dann neu. Éclair läuft mit PHP 8.1 bis 8.5; wähle nach Möglichkeit 8.3 oder neuer. Der Leitfaden [Éclair bei o2switch installieren](https://eclaircms.org/de/installation/o2switch) zeigt, wo sich diese Einstellung in cPanel befindet. ## Antwortet der KI-Assistent nicht? Schlüssel abgelehnt, Guthaben aufgebraucht, Monatsbudget erreicht, ausgehende Verbindungen blockiert: Jede Meldung hat ihre Lösung im Leitfaden zum [KI-Assistenten](https://eclaircms.org/de/dokumentation/ki-assistent#if-the-assistant-does-not-respond). ## Ist dein Problem nicht in dieser Éclair CMS Fehlerbehebung aufgeführt? Notiere die genaue Fehlermeldung, deinen Hoster und deine PHP-Version und schreib mir dann über die Seite [Kontakt](https://eclaircms.org/de/kontakt). Du kannst ein Problem auch auf [GitHub](https://github.com/Jacckisback/eclair-cms/issues) melden: Seine Lösung bereichert diese Éclair CMS Fehlerbehebung für alle Nutzer. ## Fragen zur Fehlerbehebung ### Funktioniert die Datei data/reset.php auch, wenn ich die Zwei-Faktor-Authentifizierung aktiviert habe? Ja. Die Anmeldung mit der E-Mail-Adresse und dem neuen Passwort aus der Datei deaktiviert die Zwei-Faktor-Authentifizierung dieses Kontos. Aktiviere sie danach wieder unter Mein Profil. ### Wo finde ich versteckte Dateien wie .htaccess? Aktiviere in deinem FTP-Programm die Option „Versteckte Dateien anzeigen“. Im Dateimanager von cPanel findest du sie unter Settings › Show Hidden Files (dotfiles); in der französischen Oberfläche heißt das *Paramètres › Afficher les fichiers masqués*. ### Wie finde ich heraus, welcher Fehler aufgetreten ist? Öffne Sicherheit › Letzte technische Fehler oder aktiviere vorübergehend den Debug-Modus mit einer Datei eclair-config.php. Denk daran, sie danach zu löschen. ### Meine Website zeigt eine leere Seite: Wo fange ich an? Prüfe die PHP-Version (mindestens 8.1) und aktiviere dann den Debug-Modus, um den Fehler anzuzeigen. In den meisten Fällen fehlt eine Datei oder eine PHP-Erweiterung.