WordPress Wartungsmodus: So aktivieren und beenden Sie ihn richtig

Mitten im Update steht auf Ihrer Website plötzlich nur noch ein Satz zu Wartungsarbeiten, und er verschwindet nicht mehr. Oder Sie planen einen größeren Umbau und möchten nicht, dass Besucher die Baustelle sehen. In beiden Fällen geht es um den WordPress Wartungsmodus. Dieser Artikel erklärt, wie er funktioniert, wie Sie ihn per Plugin oder Code aktivieren, was Suchmaschinen dabei sehen sollten und wann eine Staging-Umgebung die bessere Wahl ist.

Was ist der WordPress Wartungsmodus?

Im Wartungsmodus zeigt WordPress Besuchern statt der eigentlichen Inhalte eine Hinweisseite: Die Website ist vorübergehend nicht verfügbar und bald wieder erreichbar. So sieht niemand halbfertige Seiten, Fehlermeldungen oder ein zerschossenes Layout. Je nach Lösung bleiben Administratoren davon ausgenommen und können die Website ganz normal bearbeiten.

Es gibt zwei Arten: den automatischen Wartungsmodus, den WordPress bei jedem Update für wenige Sekunden selbst einschaltet, und den manuellen, den Sie bewusst für längere Arbeiten aktivieren. Beide funktionieren technisch unterschiedlich.

Der automatische Wartungsmodus bei Updates

Sobald Sie WordPress, ein Plugin oder ein Theme aktualisieren, legt WordPress im Hauptverzeichnis eine Datei namens .maintenance an. Darin steht ein Zeitstempel in der Variablen $upgrading. Solange die Datei existiert, erhalten alle Besucher eine schlichte Meldung, dass die Website wegen Wartungsarbeiten kurzzeitig nicht verfügbar ist. Dabei sendet WordPress den HTTP-Statuscode 503 und den Header Retry-After, der einen erneuten Versuch nach zehn Minuten nahelegt. Ist das Update fertig, löscht WordPress die Datei wieder.

Zwei Details sind praktisch zu wissen. Erstens ignoriert WordPress die Datei, wenn ihr Zeitstempel älter als zehn Minuten ist. Ein hängengebliebener Wartungsmodus löst sich deshalb oft von selbst. Zweitens können Sie das Aussehen der Meldung anpassen, indem Sie eine eigene Datei maintenance.php im Ordner wp-content ablegen. Diese Seite wird dann statt der Standardmeldung angezeigt. Senden Sie darin den Statuscode 503 selbst, sonst sehen Suchmaschinen eine normale Seite.

Website hängt im Wartungsmodus? So lösen Sie das Problem

Wird ein Update unterbrochen, etwa durch eine Zeitüberschreitung auf dem Server, einen Verbindungsabbruch oder einen Konflikt zwischen Plugins, bleibt die Datei .maintenance liegen. Die Website zeigt dann weiter die Meldung zu Wartungsarbeiten an. So beheben Sie das:

1. Kurz warten und neu laden

   Warten Sie einige Minuten und laden Sie die Seite ohne Cache neu. Wegen der Zehn-Minuten-Regel ist das Problem danach oft schon verschwunden.

2. Per SFTP oder Dateimanager verbinden

   Hilft das nicht, verbinden Sie sich mit einem SFTP-Programm oder öffnen Sie den Dateimanager im Kundenmenü Ihres Hosters.

3. Versteckte Dateien einblenden

   Dateien, deren Name mit einem Punkt beginnt, sind in vielen Programmen ausgeblendet. Aktivieren Sie die Anzeige versteckter Dateien.

4. Die Datei .maintenance löschen

   Wechseln Sie in das Hauptverzeichnis der WordPress-Installation, also dorthin, wo auch die wp-config.php liegt, und löschen Sie die Datei .maintenance. Die Website ist danach sofort wieder erreichbar.

5. Cache leeren

   Hat ein Caching-Plugin, der Server oder ein CDN die Wartungsseite zwischengespeichert, leeren Sie diese Caches. Sonst sehen manche Besucher die Meldung noch eine Weile.

6. Das Update prüfen

   Öffnen Sie im Backend Dashboard, Aktualisierungen und prüfen Sie, ob das Update vollständig durchgelaufen ist. Ein halb aktualisiertes Plugin installieren Sie neu. Testen Sie danach Startseite, Formulare und Login.

Vorbeugen können Sie, indem Sie auf schwächerem Hosting nicht Dutzende Plugins auf einmal aktualisieren und den Browser-Tab während eines Updates geöffnet lassen. Wie ein sicherer Update-Ablauf insgesamt aussieht, zeigt der Artikel WordPress Updates.

Den Wartungsmodus manuell aktivieren

Für geplante Arbeiten bringt WordPress keinen Schalter mit. Sie haben mehrere Möglichkeiten, die sich in Aufwand und Gestaltungsspielraum unterscheiden:

Per Plugin

Im offiziellen Plugin-Verzeichnis finden Sie unter dem Suchbegriff maintenance viele Kandidaten. Verbreitete Beispiele sind LightStart, früher unter dem Namen WP Maintenance Mode bekannt, Maintenance und der Website Builder von SeedProd, dazu kommen viele weitere. Nach der Installation stellen Sie in den Einstellungen des Plugins den Status auf aktiviert und gestalten die Wartungsseite mit Logo, Text und Farben. Manche Funktionen gibt es nur in einer Pro-Version.

Achten Sie bei jedem Plugin auf drei Punkte. Viele Plugins unterscheiden zwischen einem Wartungsmodus und einem Coming-Soon-Modus; für eine bestehende Website wählen Sie den Wartungsmodus. Legen Sie außerdem fest, welche Benutzerrollen die Website trotzdem sehen dürfen. Und prüfen Sie nach dem Aktivieren selbst, welchen Statuscode die Seite sendet. Wie das geht, steht weiter unten.

Per Code

Ohne zusätzliches Plugin genügen wenige Zeilen PHP. Am saubersten ist ein kleines Must-use-Plugin: eine Datei, etwa wartungsmodus.php, im Ordner wp-content/mu-plugins. Legen Sie den Ordner an, falls er fehlt. WordPress lädt die Datei automatisch, und zum Beenden löschen oder benennen Sie sie einfach um.

<?php
/*
 * Plugin Name: Wartungsmodus
 * Description: Zeigt Besuchern eine Wartungsseite mit Statuscode 503.
 */
add_action( 'template_redirect', function () {
    // Administratoren sehen die Website ganz normal
    if ( current_user_can( 'manage_options' ) ) {
        return;
    }
    // Hinweis an Suchmaschinen: in einer Stunde erneut versuchen
    header( 'Retry-After: 3600' );
    wp_die(
        '<h1>Wir arbeiten gerade an unserer Website</h1>
         <p>Ab 14 Uhr sind wir wieder für Sie da. In dringenden Fällen erreichen Sie uns telefonisch.</p>',
        'Wartungsarbeiten',
        array( 'response' => 503 )
    );
} );

Der Code greift nur bei Seitenaufrufen im Frontend. Die Anmeldeseite und das Backend bleiben erreichbar, eingeloggte Administratoren sehen die Website wie gewohnt. Alle anderen erhalten die Hinweisseite mit dem Statuscode 503. Den Text passen Sie in den Zeilen mit h1 und p an, den Wert hinter Retry-After in Sekunden an die geplante Dauer.

Alternativ funktioniert derselbe Code in der functions.php eines Child-Themes, dann ohne die ersten fünf Zeilen. Fügen Sie ihn nicht in die functions.php eines gekauften Themes ein, dort verschwindet er beim nächsten Theme-Update. Ein Tippfehler in PHP kann die ganze Website lahmlegen. Legen Sie deshalb vorher ein Backup an und halten Sie den SFTP-Zugang bereit.

Per .maintenance-Datei

Sie können auch den Mechanismus nachbauen, den WordPress bei Updates nutzt: eine Datei .maintenance im Hauptverzeichnis mit dem Inhalt <?php $upgrading = time(); ?>. Weil time() bei jedem Aufruf neu ausgewertet wird, greift die Zehn-Minuten-Regel nicht, und der Modus bleibt aktiv, bis Sie die Datei manuell löschen. Allerdings kommen dann auch Sie selbst nicht mehr ins Backend. Diese Variante eignet sich nur für kurze Eingriffe, bei denen Sie ausschließlich per SFTP oder Datenbank arbeiten.

Statuscode 503 und Retry-After: was Google sehen sollte

Für Besucher sieht jede Wartungsseite ähnlich aus. Für Suchmaschinen entscheidet der HTTP-Statuscode, wie sie die Seite behandeln:

• 503 Service Unavailable: Die Seite ist vorübergehend nicht verfügbar. Google behält die bisherigen Inhalte im Index und versucht es später erneut. Das ist der richtige Code für Wartungsarbeiten.
• 200 OK: Die Seite ist normal erreichbar. Sendet Ihre Wartungsseite diesen Code, wie es bei vielen Coming-Soon-Seiten der Fall ist, kann Google den Platzhalter statt Ihrer Inhalte in den Index übernehmen.

Der Header Retry-After ergänzt den Statuscode und nennt, wann sich ein neuer Versuch lohnt, entweder in Sekunden oder als Datum. Suchmaschinen und andere Programme können diesen Hinweis berücksichtigen. Auch die Dauer zählt. Ein 503 für einige Stunden ist unproblematisch. Liefert eine Website aber tagelang nur 503, kann Google Seiten aus dem Index nehmen. Längere Arbeiten gehören deshalb auf eine Staging-Umgebung.

Ob Ihre Wartungsseite den richtigen Code sendet, prüfen Sie in einem privaten Browserfenster, in dem Sie nicht eingeloggt sind: Entwicklerwerkzeuge öffnen, Reiter Netzwerk wählen, Seite neu laden und in der ersten Zeile die Spalte Status ansehen. Im Terminal geht es mit einem Befehl:

curl -I https://www.ihre-domain.de

HTTP/2 503
retry-after: 3600
content-type: text/html; charset=UTF-8

Was auf die Wartungsseite gehört

Eine gute Wartungsseite beantwortet die Fragen, die ein Besucher in diesem Moment hat. Sie muss nicht aufwendig sein:

• Eine klare Aussage, dass an der Website gearbeitet wird
• Ein konkretes voraussichtliches Ende, zum Beispiel eine Uhrzeit statt „in Kürze“
• Ein Weg, Sie trotzdem zu erreichen, etwa Telefonnummer oder E-Mail-Adresse
• Logo und Farben Ihres Unternehmens, damit Besucher sicher sind, richtig zu sein
• Wenig Ballast, also ohne große Bilder, Tracking-Skripte und Pop-ups

Ob Impressum und Datenschutzerklärung während der Wartung erreichbar bleiben müssen, ist eine rechtliche Frage, die Sie mit Ihrer Rechtsberatung klären. Technisch ist es einfach: In den meisten Plugins lassen sich einzelne Seiten vom Wartungsmodus ausnehmen, im Code-Beispiel oben ergänzen Sie dafür eine Bedingung für diese Seiten.

Wann eine Staging-Umgebung die bessere Wahl ist

Solange der Wartungsmodus aktiv ist, ist Ihre Website für Besucher und Kunden nicht nutzbar. Es kommen keine Anfragen und keine Bestellungen. Für alles, was länger dauert als ein paar Minuten, ist eine Staging-Umgebung meist der bessere Weg. Das ist eine Kopie der Website auf einer eigenen, nicht öffentlichen Adresse. Dort arbeiten Sie in Ruhe, testen alles und übertragen das Ergebnis erst am Ende auf die Live-Website. Der Wartungsmodus ist dann nur für diese kurze Umschaltung nötig.

Viele Hoster bieten Staging per Klick an, alternativ erstellen Plugins wie WP Staging eine Kopie. Achten Sie darauf, dass die Testumgebung per Passwort geschützt ist oder zumindest nicht von Suchmaschinen indexiert wird. Planen Sie einen größeren Umbau, hilft die Website-Relaunch-Checkliste. Warum der Wartungsmodus nach einem Angriff nicht ausreicht, erklärt der Artikel WordPress gehackt.

Häufige Fehler mit dem Wartungsmodus

• Vergessen: Der Modus bleibt nach den Arbeiten aktiv, und niemand merkt es, weil Administratoren die normale Website sehen. Prüfen Sie am Ende immer ausgeloggt.
• Coming-Soon statt Wartung: Eine bestehende Website sendet den Statuscode 200, und der Platzhalter landet im Index.
• Zwischengespeicherte Wartungsseite: Ein Cache liefert die Hinweisseite weiter aus, obwohl der Modus längst beendet ist.
• Ausgesperrt: Eine manuell angelegte .maintenance-Datei blockiert auch das Backend.
• Zu lange Wartung: Arbeiten über Tage gehören auf eine Staging-Umgebung, nicht hinter eine Wartungsseite.

Wartung ohne lange Ausfallzeit

Häufige Fragen