Magento-Wartungsmodus ein- und ausschalten

Der Wartungsmodus zeigt Besuchern eine Wartungsseite (HTTP 503), während du Updates oder Umbauten machst. Ein- und ausschalten geht per SSH mit bin/magento maintenance:enable und maintenance:disable — und mit einer Ausnahme für deine eigene IP arbeitest du währenddessen normal weiter.

Voraussetzungen

• SSH-Zugang als Benutzer deines Abos — siehe SSH-Zugang einrichten.
• Deine aktuelle öffentliche IP, z. B. über wieistmeineip.de — für die Ausnahme in Schritt 3.

Schritt für Schritt

1. Verbinde dich per SSH und wechsle in den Document Root: cd ~/httpdocs (cPanel: cd ~/public_html).
2. Aktiviere den Wartungsmodus: bin/magento maintenance:enable.
3. Nimm deine eigene IP aus: bin/magento maintenance:allow-ips 203.0.113.42 — du siehst den Shop dann normal, alle anderen die Wartungsseite.
4. Prüfe den Zustand jederzeit mit bin/magento maintenance:status.
5. Erledige deine Arbeiten.
6. Schalte die Wartung wieder ab: bin/magento maintenance:disable — und ruf den Shop einmal aus einem privaten Browser-Fenster auf.

Was technisch passiert

Der Modus ist nur eine Datei: var/.maintenance.flag. Existiert sie, liefert Magento die Wartungsseite. Das erklärt auch die Abkürzung im Notfall — die Datei löschen wirkt wie maintenance:disable.

Wenn etwas schiefläuft

Der Shop zeigt 503, obwohl niemand die Wartung eingeschaltet hat

Ein abgebrochenes Update (auch von Extensions oder Deploy-Tools) hinterlässt die Flag-Datei — der Shop bleibt dann dauerhaft in Wartung.

Lösung: bin/magento maintenance:status prüfen und mit maintenance:disable beenden. Wichtig: vorher klären, ob das Update sauber durchgelaufen ist — sonst erst das Update zu Ende bringen (bin/magento setup:upgrade), dann die Wartung beenden.

Nach maintenance:disable kommt weiter die Wartungsseite

Fast immer ein Cache-Rest — der 503-Zustand hängt noch im Seiten-Cache oder im Browser.

Lösung: bin/magento cache:flush ausführen und im privaten Fenster testen. Mehr dazu: Magento-Cache leeren und neu indexieren.

Du siehst trotz allow-ips selbst die Wartungsseite

Deine tatsächliche öffentliche IP weicht von der eingetragenen ab — typisch nach Router-Neustart oder im Firmennetz mit wechselnden Ausgangs-IPs.

Lösung: Aktuelle IP erneut prüfen und mit bin/magento maintenance:allow-ips <ip> neu setzen (der Befehl ersetzt die Liste, mehrere IPs durch Leerzeichen getrennt angeben).

Verwandte Artikel

• Magento-Cache leeren und neu indexieren — der Begleiter jedes Wartungsfensters.
• SSH-Zugang einrichten — Voraussetzung für die CLI-Befehle.
• IP gesperrt: kein Zugriff auf dein Projekt — falls nicht die Wartung, sondern eine Sperre dich aussperrt.

Du kommst nicht weiter?

Der Shop bleibt in Wartung oder ein Update hängt mittendrin? Ticket im Kundencenter öffnen — nenn Domain und was zuletzt lief (Update, Deployment), wir bringen den Shop mit dir zurück.