Gesamte Dokumentation

Fehlerbehebung

Éclair CMS Fehlerbehebung: Passwort vergessen, Installation gesperrt, Fehler 404 oder 500, nicht umgewandelte Bilder, fehlende E-Mails, Debug-Modus, Proxy.

Aktualisiert am 5 Min. Lesezeit

Inhalt
  1. Passwort vergessen oder Smartphone mit Zwei-Faktor-Authentifizierung verloren?
  2. „Installation gesperrt“: Was tun?
  3. Die Adresse der Website ist auf der Seite Sicherheit nicht verifiziert: Was bedeutet das?
  4. Warum Fehler 404 auf allen Seiten außer der Startseite?
  5. Was tun bei einem Fehler 500 direkt nach dem Hochladen?
  6. Warum werden Bilder nicht in WebP umgewandelt?
  7. Warum bekomme ich die E-Mails des Kontaktformulars nicht?
  8. Wie aktivierst du den Debug-Modus?
  9. Alle IP-Adressen sind gleich: Steht deine Website hinter einem Proxy?
  10. „Éclair a besoin de PHP 8.1 ou plus récent“: Was tun?
  11. Antwortet der KI-Assistent nicht?
  12. Ist dein Problem nicht in dieser Éclair CMS Fehlerbehebung aufgeführt?
  13. Fragen zur Fehlerbehebung

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:

<?php exit; ?>
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.

„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.

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
defined('ECLAIR') || exit;

// Fehlerdetails anzeigen, bis das Problem gelöst ist.
define('ECLAIR_DEBUG', true);

Fehler werden dann im Detail angezeigt, und der statische Cache ist deaktiviert. Lösche diese Datei, sobald das Problem behoben ist: Die Fehlerdetails sollen nicht für alle sichtbar sein.

Alle IP-Adressen sind gleich: Steht deine Website hinter einem Proxy?

Zeigt das Sicherheitsprotokoll für alle Besucher dieselbe IP-Adresse an, wird deine Website wahrscheinlich hinter einem Proxy oder CDN wie Cloudflare ausgeliefert. Die Limits für Versuche, die pro Netzwerk gelten, treffen dann alle gleichzeitig. Wähle unter Einstellungen › Erweitert › „Website hinter einem Proxy / CDN“ den Header, der die echte Adresse weitergibt: CF-Connecting-IP für Cloudflare, X-Forwarded-For oder X-Real-IP, je nach Hoster.

„É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 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.

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. Du kannst ein Problem auch auf GitHub 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.