Foto von Ubaid E. Alyafizi auf Unsplash
Ob ein größeres Update, ein neues Design oder Umbauten im Hintergrund: Manchmal soll eine WordPress-Webseite für kurze Zeit nicht in ihrem halbfertigen Zustand zu sehen sein. Genau dafür gibt es den Wartungsmodus. Er zeigt Besuchern eine kurze Hinweisseite, während du in Ruhe arbeitest.
In diesem Beitrag erfährst du, was der Wartungsmodus ist, wie WordPress ihn selbst nutzt, wie du ihn per Datei im Webroot manuell startest, und was du tust, wenn deine Webseite darin hängen bleibt. Dazu zeige ich den bequemen Weg über das WP Toolkit.
Was der WordPress-Wartungsmodus ist
Der WordPress-Wartungsmodus blendet deine Webseite für Besucher hinter einer kurzen Hinweisseite aus, während im Hintergrund gearbeitet wird. Bei Updates schaltet WordPress ihn automatisch ein. Du kannst ihn aber auch selbst aktivieren: per Datei im Webroot, über das WP Toolkit oder ein Plugin.
Der Sinn dahinter ist einfach. Während ein Update läuft oder du an der Technik schraubst, kann die Webseite kurz fehlerhaft aussehen oder Funktionen verlieren. Statt diesen Zwischenstand zu zeigen, sehen Besucher einen freundlichen Hinweis, dass gleich alles wieder da ist. Für dich heißt das: ungestört arbeiten, ohne dass jemand eine kaputte Webseite zu Gesicht bekommt.
Wie WordPress den Wartungsmodus automatisch nutzt
Den Wartungsmodus kennst du wahrscheinlich schon, ohne ihn je bewusst eingeschaltet zu haben. Sobald du WordPress, ein Theme oder ein Plugin aktualisierst, legt WordPress für die Dauer des Updates eine Datei namens .maintenance ins Hauptverzeichnis. Solange sie existiert, bekommt jeder Besucher die schlichte Meldung „Briefly unavailable for scheduled maintenance. Check back in a minute.”
Die Datei enthält nur eine Zeile PHP mit einem Zeitstempel:
<?php $upgrading = time(); ?>Eingebaut ist ein Sicherheitsnetz: WordPress zeigt die Wartungsmeldung nur, wenn dieser Zeitstempel jünger als zehn Minuten ist. Läuft das Update normal durch, löscht WordPress die Datei danach von selbst, und die Webseite ist sofort wieder online. Im Normalfall musst du dich also um nichts kümmern.
Den Wartungsmodus selbst über eine Datei aktivieren
Du kannst genau diesen Mechanismus auch von Hand auslösen. Lege dazu im Wurzelverzeichnis deiner Installation, dort wo auch wp-config.php liegt, eine Datei mit dem Namen .maintenance an, mit demselben Inhalt wie oben. Ab sofort sehen Besucher die Wartungsmeldung.
Zwei Dinge solltest du dabei wissen. Erstens läuft die Meldung nach zehn Minuten aus, weil der Zeitstempel dann zu alt ist. Für ein längeres Fenster setzt du den Wert einfach in die Zukunft:
<?php $upgrading = time() + 3600; ?>Zweitens sperrt dieser eingebaute Modus die komplette Webseite, auch dein eigenes Login unter /wp-admin. Zum Arbeiten im Backend musst du die Datei also zwischendurch wieder entfernen. Und die Meldung selbst ist bewusst nüchtern, ohne dein Logo, ohne Gestaltung.
Deshalb ist dieser Weg vor allem eins: schnell und technisch. Für eine geplante, hübsch gestaltete Wartungsseite gibt es die bequemeren Lösungen weiter unten.
WordPress hängt im Wartungsmodus fest? Datei löschen
Der Klassiker unter den WordPress-Schrecksekunden: Du startest ein Update, es bricht mitten drin ab (ein Timeout, ein Server-Fehler, ein unverträgliches Plugin), und danach zeigt die ganze Webseite nur noch „Briefly unavailable for scheduled maintenance”. Der Grund ist harmlos: Das Update konnte die .maintenance-Datei nicht mehr aufräumen, also bleibt sie liegen.
Die Lösung dauert eine Minute:
- Verbinde dich per FTP oder öffne den Dateimanager deines Hosters.
- Wechsle ins Wurzelverzeichnis der WordPress-Installation, auf dieselbe Ebene wie
wp-config.phpund den Ordnerwp-content. - Lösche die Datei
.maintenance.
Weil der Name mit einem Punkt beginnt, ist die Datei versteckt. Im FTP-Programm aktivierst du dafür meist erst „versteckte Dateien anzeigen”. Sobald die Datei weg ist, lädt die Webseite wieder normal. Zeigt ein Cache noch die alte Meldung, leerst du ihn einmal.
Ein Tipp aus der Praxis: Wenn ein Update reproduzierbar hängen bleibt, steckt oft ein zu knappes PHP-Zeitlimit oder ein fehlerhaftes Plugin dahinter. Ein aktuelles Backup vor jedem Update erspart dir im Ernstfall den Stress. Genau deshalb gehören Updates in ruhige Hände, mehr dazu im Beitrag zur WordPress-Wartung.
Den Wartungsmodus über das WP Toolkit aktivieren
Bei meinem WordPress-Webhosting läuft Plesk mit dem WP Toolkit, und damit wird der Wartungsmodus zur Ein-Klick-Sache. Auf der Kachel deiner WordPress-Installation gibt es einen Schalter „Wartungsmodus”. Einmal umlegen, und die Webseite ist für Besucher im Wartungsmodus, ohne dass du eine einzige Datei anfassen musst. Zum Beenden legst du den Schalter wieder zurück.
Der Vorteil gegenüber der .maintenance-Datei: Die Wartungsseite lässt sich anpassen. Du kannst den Text ändern, einen Countdown einblenden oder Links ergänzen. Und du sperrst dich nicht selbst aus, du arbeitest normal weiter, während Besucher die Wartungsseite sehen. Für eine geplante Wartung ist das der sauberste Weg.
Eine schönere Wartungsseite: Plugin oder eigene Vorlage
Wer kein passendes Hosting-Werkzeug hat, greift zum Plugin. Lösungen wie „WP Maintenance”, „LightStart” (früher WP Maintenance Mode) oder SeedProd bringen eine gestaltete Wartungsseite mit: mit deinem Logo, einem Text, oft auch einem Countdown oder einem Anmeldeformular für den Newsletter. Angemeldete Administratoren werden dabei durchgelassen und sehen die echte Webseite.
Wer es ganz ohne Plugin und ohne fremde Meldung mag, kann eine eigene Vorlage hinterlegen: Legt man eine Datei maintenance.php in den Ordner wp-content, nutzt WordPress diese als Wartungsseite, sobald der Modus aktiv ist. So bekommst du eine gestaltete Seite im eigenen Look, ohne zusätzliches Plugin.
Fazit
Der WordPress-Wartungsmodus ist kein Hexenwerk. Bei Updates erledigt WordPress ihn automatisch über die .maintenance-Datei, und wenn eine Webseite darin hängen bleibt, reicht ein Blick ins Wurzelverzeichnis und das Löschen dieser einen Datei. Für den schnellen manuellen Einsatz legst du die Datei selbst an, für eine geplante, gestaltete Wartung nimmst du das WP Toolkit oder ein Plugin.
Am Ende ist der Wartungsmodus nur ein kleiner Baustein sauberer WordPress-Pflege. Wenn du den ganzen Rest, Updates, Backups und Sicherheit, in verlässliche Hände geben willst, sieh dir meine WordPress-Wartung an oder schreib mir einfach.
Häufige Fragen
Wie aktiviere ich den WordPress-Wartungsmodus?
Bei Updates schaltet WordPress ihn automatisch ein. Manuell hast du drei Wege: eine Datei namens .maintenance mit dem Inhalt <?php $upgrading = time(); ?> ins Hauptverzeichnis legen, den Wartungsmodus im WP Toolkit deines Hosters mit einem Klick einschalten, oder ein Plugin nutzen. Für eine gestaltete Wartungsseite sind WP Toolkit oder Plugin die bessere Wahl.
WordPress hängt im Wartungsmodus fest, was tun?
Das passiert, wenn ein Update abbricht und die .maintenance-Datei liegen bleibt. Die Lösung: Verbinde dich per FTP oder über den Dateimanager deines Hosters, geh ins Hauptverzeichnis der WordPress-Installation (dort, wo auch wp-config.php liegt) und lösche die Datei .maintenance. Danach lädt die Webseite sofort wieder normal.
Wo liegt die .maintenance-Datei?
Im Wurzelverzeichnis deiner WordPress-Installation, auf derselben Ebene wie wp-config.php und der Ordner wp-content. Weil der Dateiname mit einem Punkt beginnt, ist die Datei versteckt. Im FTP-Programm musst du dafür oft erst 'versteckte Dateien anzeigen' aktivieren.
Sperrt der Wartungsmodus auch den Login?
Der eingebaute Wartungsmodus über die .maintenance-Datei blockiert die ganze Webseite, auch den Login unter /wp-admin. Solange die Datei aktiv ist, kommst du selbst nicht ins Backend. Plugins und das WP Toolkit lösen das eleganter: Dort siehst du als angemeldeter Administrator die normale Webseite, während Besucher die Wartungsseite bekommen.
