Shopware-Wartungsmodus ein- und ausschalten

Der Wartungsmodus zeigt Besuchern eine Wartungsseite, während du am Shop arbeitest. In Shopware 6 gilt er pro Verkaufskanal — du schaltest ihn im Admin am jeweiligen Kanal ein (mit Allowlist für deine eigene IP) oder per SSH mit bin/console sales-channel:maintenance:enable.

Voraussetzungen

• Zugang zum Shopware-Admin — oder für den CLI-Weg SSH-Zugang, siehe SSH-Zugang einrichten.
• Deine aktuelle öffentliche IP für die Allowlist, z. B. über wieistmeineip.de.

Schritt für Schritt

Admin

1. Melde dich im Shopware-Admin an.
2. Wähl in der Seitenleiste unter Verkaufskanäle den betroffenen Kanal.
3. Aktiviere im Bereich Status den Wartungsmodus.
4. Trag deine IP in die Allowlist des Wartungsmodus ein — du siehst den Shop dann normal, alle anderen die Wartungsseite.
5. Speichere, erledige deine Arbeiten und schalte den Modus danach wieder aus.

SSH (CLI)

1. Verbinde dich per SSH und wechsle in den Document Root: cd ~/httpdocs (cPanel: cd ~/public_html).
2. Aktiviere die Wartung für alle Verkaufskanäle: bin/console sales-channel:maintenance:enable --all.
3. Erledige deine Arbeiten.
4. Beende die Wartung: bin/console sales-channel:maintenance:disable --all.
5. Ruf die Storefront aus einem privaten Browser-Fenster auf, um den Normalzustand zu prüfen.

Pro Verkaufskanal gedacht

Weil der Modus am Verkaufskanal hängt, kannst du gezielt nur einen Shop in Wartung schicken — andere Kanäle (z. B. eine zweite Storefront) laufen weiter. Der --all-Schalter der CLI nimmt bewusst alle auf einmal.

Wenn etwas schiefläuft

Du siehst selbst die Wartungsseite, trotz Allowlist

Deine tatsächliche öffentliche IP weicht von der eingetragenen ab — typisch nach Router-Neustart oder aus dem Mobilfunknetz.

Lösung: IP aktuell prüfen und die Allowlist am Verkaufskanal korrigieren. Zur Not per CLI deaktivieren: bin/console sales-channel:maintenance:disable --all.

Nach dem Deaktivieren bleibt die Wartungsseite stehen

Der alte Zustand hängt noch im Cache — auf dem Server oder im Browser.

Lösung: bin/console cache:clear ausführen und im privaten Fenster testen — siehe Shopware-Cache leeren.

Der Admin ist während der Wartung nicht erreichbar

Der Wartungsmodus betrifft nur die Storefront — ein gesperrter Admin hat eine andere Ursache, etwa eine IP-Sperre nach Login-Fehlversuchen.

Lösung: Den Fahrplan in IP gesperrt: kein Zugriff auf dein Projekt durchgehen.

Verwandte Artikel

• Shopware-Cache leeren — der Begleiter jedes Wartungsfensters.
• SSH-Zugang einrichten — Voraussetzung für den CLI-Weg.
• IP gesperrt: kein Zugriff auf dein Projekt — falls dich nicht die Wartung aussperrt.

Du kommst nicht weiter?

Wartung hängt, Allowlist greift nicht oder ein Kanal verhält sich anders als erwartet? Ticket im Kundencenter öffnen — nenn Domain und Verkaufskanal, wir lösen das gemeinsam.