Shopware Wartungsmodus
Den Shop vorübergehend für Besucher schließen, während das Team weiterarbeitet.
Definition
Der Wartungsmodus sperrt einen Verkaufskanal in Shopware 6 vorübergehend für Besucher und zeigt stattdessen eine Wartungsseite. Freigegebene IP-Adressen sehen den Shop weiterhin normal, damit das Team testen und arbeiten kann.
Der Wartungsmodus wird je Verkaufskanal aktiviert, in der Administration im jeweiligen Verkaufskanal im Bereich Status. Dort steht auch die Liste der IP-Adressen, die den Shop trotz Wartung sehen dürfen. Welche Seite Besucher stattdessen sehen, bestimmt ein Layout aus den Erlebniswelten, das unter Einstellungen > Shop > Stammdaten als Wartungsseite zugewiesen wird.
Für Updates und Deployments lässt sich der Modus auch per Konsole steuern, für alle Verkaufskanäle auf einmal. Läuft der Shop hinter einem Proxy oder CDN, muss in der .env die Variable TRUSTED_PROXIES gesetzt sein. Sonst sieht Shopware statt der echten IP-Adresse nur die des Proxys, und die Freigabe greift nicht.
Bei einer Migration spielt der Wartungsmodus zweimal eine Rolle. Der neue Shop bleibt bis zum Livegang im Wartungsmodus, freigeschaltet nur für das Team. Am Umstelltag geht der alte Shop in Wartung, damit zwischen letzter Datenübernahme und Domainwechsel keine Bestellungen mehr eingehen. Den kompletten Ablauf beschreibt Schritt 6 im Beitrag Shopware Relaunch mit KI.
bin/console sales-channel:maintenance:enable --allbin/console sales-channel:maintenance:disable --allPraxisbeispiel
Vor einem größeren Update schaltet ein Händler um 22 Uhr alle Verkaufskanäle per Konsole in den Wartungsmodus. Das Team testet den Shop über die freigegebenen IP-Adressen, Kunden sehen eine Wartungsseite mit dem Hinweis, wann der Shop wieder öffnet. Nach dem Test beendet ein zweiter Befehl die Wartung, der Shop war 40 Minuten geschlossen.
Was du wissen solltest
- Der Wartungsmodus gilt je Verkaufskanal, nicht automatisch für alle
- Eigene IP-Adressen vorher freigeben, sonst sieht auch das Team nur die Wartungsseite
- Für Deployments per Konsole: sales-channel:maintenance:enable --all und sales-channel:maintenance:disable --all
- Hinter Proxy oder CDN TRUSTED_PROXIES in der .env setzen, sonst greift die IP-Freigabe nicht
- Eine eigene Wartungsseite als Erlebniswelt anlegen, mit Hinweis, wann der Shop wieder erreichbar ist
- Wartungsfenster kurz halten und in umsatzschwache Zeiten legen
Shopware Agentur
Du willst dieses Thema in deinem Projekt sauber umsetzen? Wir helfen dabei.
Zur Leistungsseite