Nach einem WordPress-Update erscheint plötzlich nur noch die Meldung „Briefly unavailable for scheduled maintenance“. Kurz darauf sollte die Website normalerweise wieder erreichbar sein. Bleibt diese Anzeige bestehen, ist der Wartungsmodus hängen geblieben.
In vielen Fällen lässt sich das Problem ohne kompletten Neuaufbau der Website beheben. In diesem Beitrag erfährst du, wie der WordPress-Wartungsmodus funktioniert, warum er aktiv bleiben kann und welche Schritte du bei der Fehlerbehebung durchführen solltest.
Was passiert beim WordPress-Wartungsmodus?
Während eines Updates legt WordPress im Hauptverzeichnis deiner Installation vorübergehend eine Datei mit dem Namen .maintenance an. Diese Datei signalisiert WordPress, dass gerade Wartungsarbeiten stattfinden. Besucher sehen in dieser Zeit eine Wartungsmeldung, damit keine unvollständig aktualisierten Inhalte ausgeliefert werden.
Nach einem erfolgreichen Update entfernt WordPress die Datei normalerweise wieder automatisch. Wird der Vorgang jedoch unterbrochen, kann die Datei bestehen bleiben. Gründe dafür können beispielsweise ein abgebrochenes Update, ein Timeout oder ein anderes technisches Problem während des Aktualisierungsvorgangs sein.
Bevor du die Datei löschst: kurz prüfen
Rufe die Website zunächst nach einigen Minuten erneut auf. Bei umfangreicheren Updates kann der Vorgang etwas Zeit benötigen. Prüfe außerdem, ob die Wartungsmeldung nur im Browser-Cache angezeigt wird. Öffne die Website testweise in einem privaten Browserfenster oder lösche den Cache.
Wenn die Meldung dauerhaft erscheint und du sicher bist, dass gerade kein Update mehr läuft, kannst du die .maintenance-Datei entfernen. Erstelle vorher möglichst ein Backup deiner Website. Falls du regelmäßig Sicherungen anlegst, findest du im Beitrag zur Bedeutung regelmäßiger Backups weitere Grundlagen.
Schritt 1: Per FTP oder Dateimanager auf die Website zugreifen
Für die Behebung benötigst du Zugriff auf die Dateien deiner WordPress-Installation. Je nach Hosting stehen dir dafür unterschiedliche Möglichkeiten zur Verfügung:
- ein FTP-Programm,
- der Dateimanager deines Hostings,
- ein SSH-Zugang, sofern dieser für deine Installation verfügbar ist.
Öffne das Hauptverzeichnis von WordPress. Dort findest du normalerweise unter anderem die Ordner wp-admin, wp-content und wp-includes. Die Datei .maintenance liegt auf derselben Ebene.
Schritt 2: Die .maintenance-Datei sichtbar machen
Bei Dateien, deren Name mit einem Punkt beginnt, handelt es sich häufig um sogenannte versteckte Dateien. Manche FTP-Programme und Dateimanager zeigen sie standardmäßig nicht an. Aktiviere in diesem Fall die Option zum Anzeigen versteckter Dateien.
Achte darauf, wirklich das Hauptverzeichnis deiner WordPress-Installation zu öffnen. Die Datei befindet sich nicht im Ordner wp-content.
Schritt 3: Die .maintenance-Datei löschen
Wenn kein Update mehr läuft, lösche ausschließlich die Datei .maintenance. Verändere keine anderen WordPress-Dateien und lösche nicht den gesamten Ordner deiner Installation.
Rufe deine Website anschließend erneut auf. Wenn die Datei die Ursache war, sollte die Wartungsmeldung verschwunden sein. Melde dich danach im WordPress-Dashboard an und prüfe, ob alle Updates abgeschlossen wurden.
Was du nach der Behebung prüfen solltest
Updates kontrollieren
Öffne im Dashboard den Bereich Dashboard > Aktualisierungen. Prüfe, ob WordPress, Plugins oder Themes noch als ausstehend angezeigt werden. Aktualisiere fehlende Komponenten nicht alle gleichzeitig, wenn du die Ursache eines Problems noch nicht kennst. So lässt sich leichter nachvollziehen, welches Update möglicherweise Schwierigkeiten verursacht hat.
Website und zentrale Funktionen testen
Rufe nicht nur die Startseite auf. Teste auch wichtige Unterseiten, Formulare, die Anmeldung und gegebenenfalls Funktionen, die von deinen Plugins bereitgestellt werden. Achte auf Fehlermeldungen oder leere Seiten.
Fehlerprotokolle prüfen
Wenn die Wartungsmeldung verschwunden ist, die Website aber weiterhin Fehler zeigt, solltest du die eigentliche Ursache untersuchen. WordPress kann bei der Fehlersuche mit Debugging und Protokollen helfen. Eine Einführung findest du im Beitrag WP Debug: Fehler in WordPress erkennen und beheben.
Wenn die .maintenance-Datei nicht die Ursache ist
Manchmal sieht die Meldung wie ein Wartungsmodus-Problem aus, obwohl ein anderes Problem dahintersteckt. Prüfe dann die folgenden Punkte:
- Wurde während des Updates die Verbindung zum Hosting unterbrochen?
- Ist ausreichend Speicherplatz auf dem Webhosting vorhanden?
- Wurde nur ein einzelnes Plugin oder Theme aktualisiert?
- Zeigt das Hosting eigene Fehlermeldungen oder Einschränkungen an?
- Ist die Website nur für dich oder auch für andere Besucher nicht erreichbar?
Wenn du Zugriff auf die WordPress-Dateien hast, kannst du bei einem Plugin-Verdacht testweise den betreffenden Plugin-Ordner umbenennen. Dadurch wird das Plugin in vielen Fällen deaktiviert. Ändere dabei nur den Namen des vermuteten Plugin-Ordners und dokumentiere die Änderung, damit du sie später rückgängig machen kannst.
So vermeidest du Probleme bei künftigen Updates
- Erstelle vor größeren Änderungen ein aktuelles Backup.
- Halte WordPress, Plugins und Themes nicht über lange Zeit auf einem alten Stand.
- Führe Updates möglichst einzeln durch, wenn du Fehler leichter zuordnen möchtest.
- Vermeide es, während eines laufenden Updates die Seite zu schließen oder mehrfach neue Updates zu starten.
- Teste wichtige Änderungen nach dem Update auf der Website.
Für umfangreichere Änderungen kann außerdem eine separate Staging- oder Entwicklungsumgebung sinnvoll sein. Dort lassen sich Updates zunächst testen, ohne direkt die produktive Website zu verändern. Mehr dazu erfährst du im Beitrag Staging- und Entwicklungsumgebung.
Fazit
Ein dauerhaft angezeigter WordPress-Wartungsmodus wird häufig durch eine zurückgebliebene .maintenance-Datei verursacht. Wenn kein Update mehr läuft, kannst du die Datei per FTP oder über den Dateimanager deines Hostings aus dem WordPress-Hauptverzeichnis entfernen.
Prüfe anschließend die Aktualisierungen, teste die wichtigsten Funktionen und untersuche weitere Fehlermeldungen bei Bedarf mit dem WordPress-Debugging. Erstelle vor solchen Änderungen möglichst ein Backup. Wenn du bei der Fehlerbehebung nicht weiterkommst, kannst du Unterstützung für deine WordPress-Website anfragen.