WordPress Wartungsmodus geht nicht weg: So beenden Sie ihn Schritt für Schritt

Was im Hintergrund passiert

Bevor WordPress den Kern, ein aktives Plugin oder ein aktives Theme aktualisiert, legt es im Hauptverzeichnis der Installation die Datei .maintenance an. Sie enthält nur einen Zeitstempel. Solange der Zeitstempel frisch ist, beendet WordPress jede Anfrage früh mit einer Wartungsmeldung und dem Statuscode 503. Nach dem Update löscht es die Datei wieder.

Das zeigt der Quellcode von WordPress (Stand: Oktober 2026):

• Wann der Wartungsmodus startet: bei Updates des Kerns, beim gleichzeitigen Aktualisieren mehrerer Plugins oder Themes, sofern ein aktives darunter ist, und bei automatischen Hintergrund-Updates eines aktiven Plugins oder Themes. Ein einzelnes, von Hand angestoßenes Plugin-Update löst ihn nicht aus.
• Wie er endet: WordPress löscht die Datei nach dem Update. Ist der Zeitstempel älter als zehn Minuten, betrachtet WordPress den Wartungsmodus als beendet und ignoriert die Datei.
• Was Besucher sehen: im englischen Original „Briefly unavailable for scheduled maintenance. Check back in a minute.“, in der deutschen Übersetzung (Sie-Form) „Diese Website ist aufgrund planmäßiger Wartungsarbeiten vorübergehend nicht verfügbar. Bitte versuchen Sie es in wenigen Minuten erneut.“ Dazu sendet WordPress den Statuscode 503 und den Header Retry-After: 600.
• Wer die Meldung sieht: alle, auch angemeldete Administratoren. Die Prüfung läuft sehr früh, noch bevor Plugins geladen werden. Deshalb ist auch der Verwaltungsbereich gesperrt.
• Eigene Wartungsseite: Liegt die Datei wp-content/maintenance.php vor, zeigt WordPress deren Inhalt statt des Standardtextes.

Erst erkennen: Welcher Wartungsmodus ist es?

Nicht jede Wartungsseite stammt von WordPress selbst. Die Beobachtung zeigt meist, wo Sie ansetzen müssen:

Prüfen Sie außerdem in einem privaten Browserfenster, auf einem anderen Gerät oder im Mobilfunknetz, ob die Meldung wirklich vom Server kommt. Browser, Caching-Plugins und CDN können eine Wartungsseite zwischenspeichern.

Schritt für Schritt: Wartungsmodus beenden

1. Zehn Minuten warten und neu ladenLäuft das Update noch, greifen Sie nicht ein. Warten Sie zehn Minuten ab dem Start des Updates. Danach ignoriert WordPress eine liegen gebliebene Datei. Laden Sie die Seite anschließend in einem privaten Fenster neu.
2. Zugang zu den Dateien herstellenÖffnen Sie den Dateimanager Ihres Hosting-Panels oder verbinden Sie sich per FTP oder SFTP. Wechseln Sie in das Verzeichnis, in dem wp-config.php, wp-admin und wp-includes liegen. Der Ordner wp-content ist nicht gemeint.
3. Versteckte Dateien einblendenDateien, deren Name mit einem Punkt beginnt, blenden viele Programme aus. Schalten Sie die Anzeige versteckter Dateien ein, bei FileZilla zum Beispiel im Menü „Server“.
4. Die Datei „.maintenance“ löschenLöschen Sie die Datei oder benennen Sie sie zur Sicherheit in .maintenance-alt um. Per SSH genügt rm .maintenance, mit WP-CLI der Befehl wp maintenance-mode deactivate.
5. Zwischenspeicher leeren und testenLaden Sie Startseite und Verwaltungsbereich neu. Leeren Sie bei Bedarf Browser-Cache, Caching-Plugin und CDN. Kommt die Wartungsseite nicht zurück, ist der Wartungsmodus beendet.
6. Das Ergebnis des Updates prüfenÖffnen Sie „Dashboard → Aktualisierungen“. Sind dort weiterhin Updates offen, spielen Sie sie nach einer Sicherung erneut ein. Nach einem unterbrochenen Update des Kerns bietet WordPress an gleicher Stelle an, die Version neu zu installieren, und verlangt gegebenenfalls ein Datenbank-Update.

cd /pfad/zur/wordpress-installation
ls -la | grep maintenance
wp maintenance-mode status
wp maintenance-mode deactivate

# ohne WP-CLI:
rm .maintenance

Wenn die Datei fehlt: Plugin, Theme oder Hoster

Gibt es keine Datei .maintenance, oder kommt die Meldung nach dem Löschen sofort zurück, stammt die Wartungsseite meist nicht vom Update-Mechanismus.

• Wartungsmodus-Plugin oder Page Builder: Melden Sie sich an und schalten Sie den Modus in den Einstellungen des Plugins aus, oder deaktivieren Sie das Plugin unter „Plugins → Installierte Plugins“.
• Kein Zugang zum Verwaltungsbereich: Benennen Sie den Ordner des Plugins unter wp-content/plugins um, zum Beispiel wartungsmodus-plugin in wartungsmodus-plugin_aus. WordPress deaktiviert es dann. Mit WP-CLI geht es über wp plugin deactivate plugin-name.
• Theme-Funktion: Manche Themes bringen einen eigenen Wartungs- oder „Coming soon“-Schalter mit. Suchen Sie ihn in den Theme-Einstellungen oder im Customizer.
• Hoster: Zeigt die Seite die Gestaltung Ihres Hosters, prüfen Sie Vertrag und Zahlungsstatus, Störungsmeldungen und den Kundenbereich.
• Eigene Wartungsseite: Liegt wp-content/maintenance.php vor, bestimmt diese Datei das Aussehen der WordPress-Wartungsseite. Sie erscheint nur, solange der Wartungsmodus des Kerns aktiv ist.

Warum Updates abbrechen

Ein Update bricht ab, wenn der Prozess endet, bevor WordPress die Datei löschen kann. Häufige Gründe:

Taucht die Datei nach dem Löschen nach einigen Minuten wieder auf, kann ein fehlgeschlagenes automatisches Update immer wieder neu gestartet werden. Prüfen Sie dann unter „Dashboard → Aktualisierungen“ und „Werkzeuge → Website-Zustand“, welche Erweiterung betroffen ist, und schalten Sie deren automatische Updates ab, bis die Ursache geklärt ist.

Geplante Wartung: Wartungsseite richtig anzeigen

Wollen Sie die Website bewusst kurz offline nehmen, etwa für einen Umbau, sollte die Wartungsseite wie bei WordPress selbst den Statuscode 503 liefern, möglichst mit dem Header Retry-After. Mehr dazu steht im Ratgeber Website nicht erreichbar.

Google verlangsamt bei Serverfehlern das Crawling vorübergehend. Bereits indexierte URLs bleiben zunächst im Index, werden bei anhaltenden Fehlern aber irgendwann entfernt. Halten Sie Wartungsfenster deshalb kurz und lassen Sie keine Wartungsseite über längere Zeit stehen.

So vermeiden Sie den Fehler beim nächsten Update

1. Vor jedem Update eine Sicherung von Dateien und Datenbank anlegen und prüfen, dass sie sich wiederherstellen lässt.
2. Updates nacheinander statt alle auf einmal einspielen und nach jedem Schritt kurz die Funktionen testen.
3. Den Browser-Tab während des Updates offen lassen und währenddessen keine weiteren Änderungen vornehmen.
4. Größere Updates in ruhigen Zeiten durchführen, nicht kurz vor einer Kampagne.
5. Bei geschäftskritischen Websites zuerst eine Testkopie aktualisieren, sofern der Hoster eine anbietet.
6. Freien Speicherplatz, PHP-Limits und die PHP-Version regelmäßig prüfen, siehe Ratgeber Website-Wartung.
7. Die Erreichbarkeit überwachen lassen, damit Sie von einem Ausfall nicht erst durch Kunden erfahren.

Wann Sie Hilfe holen sollten

Hilfe lohnt sich, wenn Sie keinen Zugang zu Dateien oder Hosting haben, die Meldung nach dem Löschen der Datei wiederkehrt, das Update erkennbar nur zur Hälfte durchgelaufen ist oder Sie nach dem Eingriff Daten vermissen.

Das Beenden eines hängenden Wartungsmodus und die Kontrolle des Updates gehören zu unserer Schnellreparatur (149 €, 2 Werktage). Regelmäßige, geordnete Updates mit Sicherung übernimmt die Website-Pflege (49 € / Monat). Die Preise verstehen sich netto zzgl. 19 % USt.

Häufige Fragen

Weiterlesen