Shopware-Wartungsmodus: je Verkaufskanal, mit IP-Freigabe und dem Fallstrick HTTP-Cache
Der Wartungsmodus in Shopware gilt je Verkaufskanal, lässt freigegebene IP-Adressen durch und antwortet Besuchern mit 503. In 6.7 kann der HTTP-Cache ihn verdecken. Was der Quelltext dazu sagt, nachgestellt in 6.6 und 6.7.

Wer einen Shop aktualisiert, ein Plugin tauscht oder Daten importiert, will dabei keine Bestellungen annehmen. Dafür hat Shopware den Wartungsmodus. Er ist schnell eingeschaltet. Ob er auch wirkt, ist eine zweite Frage — und die Antwort hängt in Shopware 6.7 vom HTTP-Cache ab.
Wir haben den Wartungsmodus am 27.10.2026 in Shopware 6.6.10.6 und 6.7.2.2 nachgestellt, am 30.10.2026 die zuständigen Stellen im Quelltext gelesen und am 11.11.2026 alles noch einmal in frischen Testinstallationen wiederholt. Was hier steht, gilt für diese beiden Versionen; den Quelltext haben wir zusätzlich mit 6.6.10.30 und 6.7.15.1 abgeglichen.
Wartungsmodus heißt: ein Schalter je Verkaufskanal
In Shopware gibt es keinen einen Schalter für den ganzen Shop. Der Wartungsmodus ist eine Eigenschaft des Verkaufskanals. Sie finden ihn in der Administration unter Verkaufskanäle → Ihr Kanal → Abschnitt „Wartungsmodus“. Dort stehen zwei Felder:
| Feld | Wirkung |
|---|---|
| Wartungsmodus | schaltet den Kanal für Besucher ab |
| Allowlist für IP-Adressen | Adressen, die den Kanal trotzdem normal sehen (IPv4 und IPv6) |
Hat ein Shop mehrere Verkaufskanäle — etwa je Land oder einen B2B-Kanal —, wirkt der Schalter nur auf den Kanal, in dem Sie ihn setzen. Das ist praktisch, wenn nur ein Kanal betroffen ist. Bei einem Update ist es eine Falle: Der vergessene zweite Kanal nimmt weiter Bestellungen an.
Per Konsole: alle Kanäle auf einmal
Für Updates und Deployments ist die Konsole zuverlässiger als die Administration. Ein- und Ausschalten sind zwei getrennte Schritte mit Ihrer Arbeit dazwischen.
Vor der Wartung einschalten, danach den HTTP-Cache leeren und die Wirkung von außen prüfen (Abschnitt „Der Fallstrick in 6.7“):
bin/console sales-channel:maintenance:enable --all
bin/console cache:clear:http
Erst wenn die Arbeiten abgeschlossen und über die freigegebene Adresse geprüft sind, wieder ausschalten und danach erneut von außen prüfen:
bin/console sales-channel:maintenance:disable --all
Ohne --all erwartet der Befehl die IDs der Verkaufskanäle. In unserem Test meldete Shopware danach „Updated maintenance mode for 2 sales channel(s)“ — die Zahl lohnt einen Blick, denn sie sagt, wie viele Kanäle wirklich umgestellt wurden.
Was Besucher sehen
Laut Quelltext prüft ein Storefront-Subscriber jede Anfrage. Ist der Wartungsmodus aktiv und die Adresse nicht freigegeben, leitet er mit Statuscode 307 auf /maintenance um. Die Wartungsseite selbst antwortet mit:
HTTP/1.1 503 Service Temporarily Unavailable
Retry-After: 3600
503 bedeutet „vorübergehend nicht verfügbar“, Retry-After schlägt einen neuen Versuch nach einer Stunde vor. Ohne eigenes Layout zeigt Shopware eine Standardseite. Ein eigenes Layout aus den Erlebniswelten lässt sich in den Grundeinstellungen als Wartungsseite hinterlegen.
Zwei Ausnahmen stehen ausdrücklich im Code: Anfragen per XMLHttpRequest werden nicht umgeleitet, und die Prüfung greift nur bei Anfragen an einen Verkaufskanal. Die Administration bleibt erreichbar, die Anmeldung an der Admin-API klappte in unserem Test im Wartungsmodus normal. In 6.7.15.1 läuft die Umleitung über ein eigenes Ereignis (MaintenanceRedirectEvent); Plugins können Ziel und Statuscode damit ändern, der Standard bleibt 307.
Store API und Headless-Frontends
Die Store API hat eine eigene Sperre. Sie sitzt nicht in der Storefront, sondern in der Prüfung des Zugangsschlüssels (sw-access-key). Ist der Verkaufskanal im Wartungsmodus und die Adresse nicht freigegeben, antwortet jede Store-API-Anfrage mit:
HTTP/1.1 503 Service Unavailable
{"errors":[{"status":"503","code":"FRAMEWORK__API_SALES_CHANNEL_MAINTENANCE_MODE",
"title":"Service Unavailable","detail":"The sales channel is in maintenance mode.", …}]}
Das haben wir am 30.10. und erneut am 11.11.2026 in 6.6.10.6 und 6.7.2.2 nachgestellt: /store-api/context lieferte vorher 200, im Wartungsmodus 503, danach wieder 200. Anders als die Storefront-Seiten kam die Sperre der Store API in 6.7.2.2 sofort, ohne Umweg über den Cache. Im Quelltext von 6.6.10.30 und 6.7.15.1 ist die Sperre unverändert. Ausnahmen sind freigegebene IP-Adressen und Routen, die ausdrücklich für den Wartungsmodus markiert sind — im Kern trägt keine Store-API-Route diese Markierung.
Für ein Headless-Frontend heißt das: Es bekommt im Wartungsmodus keine Daten mehr und muss die 503-Antwort selbst als Wartungsseite darstellen. Eine Umleitung auf /maintenance gibt es dort nicht. Achtung bei der IP-Freigabe: Fragt der Server des Frontends die Store API ab, sieht Shopware dessen Adresse, nicht die des Besuchers.
Der Fallstrick in 6.7: der HTTP-Cache
Hier unterschieden sich die beiden Versionen in unserem Test deutlich:
| Version | direkt nach maintenance:enable | nach cache:clear:http |
|---|---|---|
| 6.6.10.6 | sofort 307 → /maintenance | — |
| 6.7.2.2 | weiter 200, Seite aus dem HTTP-Cache | 307 → /maintenance, dort 503 |
In 6.7.2.2 sahen Besucher ohne Freigabe den Shop also weiter, solange die Seite im Cache lag — obwohl die Administration den Wartungsmodus als aktiv anzeigte.
Die Ursache haben wir am 30.10.2026 im Produktivmodus nachgestellt und am 11.11.2026 bestätigt. Shopware 6.7 verwirft Cache-Einträge nicht sofort, sondern sammelt sie und verwirft sie beim nächsten Lauf der geplanten Aufgabe shopware.invalidate_cache (Standardintervall fünf Minuten). Auch 20 Sekunden nach dem Einschalten kam die Startseite noch mit 200 aus dem Cache. Nach einem manuellen Lauf dieser Aufgabe leitete 6.7.2.2 sofort mit 307 um. In 6.6 ist die Invalidierung standardmäßig sofort, deshalb griff der Wartungsmodus dort ohne Verzögerung. Im Quelltext von 6.7.15.1 ist die verzögerte Invalidierung weiter voreingestellt; nachgestellt haben wir diese Version nicht.
Läuft der Worker für geplante Aufgaben nicht, bleibt der Shop für Besucher aus dem Cache erreichbar, bis jemand den Cache leert. Wie die Aufgaben laufen und woran man einen stehenden Worker erkennt, beschreibt Warum ein Scheduled Task nicht läuft.
Wie stark der HTTP-Cache den Shop trägt, zeigt unsere Messung Ein Artikel im Warenkorb kostet den HTTP-Cache: Anonyme Besucher bekommen cachebare Seiten aus dem HTTP-Cache, solange er eingeschaltet ist — und damit auch eine Seite, die vor dem Wartungsmodus entstanden ist.
IP-Freigabe: welche Adresse Shopware sieht
Die Allowlist vergleicht die Adresse der Anfrage mit den eingetragenen Werten — in der Storefront und in der Store API. Im Kern geschieht das über Request::getClientIp() und IpUtils::checkIp() aus Symfony. Damit sind auch Netzbereiche in CIDR-Schreibweise möglich, etwa 203.0.113.0/24.
Wichtig ist, welche Adresse Shopware sieht. Die folgenden Punkte haben wir nicht gemessen, sie folgen aus dem Verhalten von Symfony. Steht ein Proxy, Load Balancer oder CDN vor dem Shop, kommt die Anfrage technisch von dessen Adresse. Die echte Besucheradresse steht dann in einem Header wie X-Forwarded-For. Symfony wertet diesen Header nur aus, wenn der Proxy als vertrauenswürdig konfiguriert ist. Fehlt diese Einstellung, gibt es zwei mögliche Folgen:
- Ihre eigene Adresse auf der Allowlist wirkt nicht, weil Shopware nur den Proxy sieht.
- Jemand trägt die Adresse des Proxys ein — und gibt damit den Shop für alle Besucher frei.
Wie der Proxy bei Ihnen eingetragen ist, legt das Hosting fest. Prüfen Sie es vor der ersten Wartung, nicht währenddessen.
Wartungsmodus und Update sind zwei Dinge
Der Verkaufskanal-Wartungsmodus sperrt die Storefront. Die Befehle bin/console system:update:prepare und system:update:finish gehören zum Update selbst: Sie lösen die Vorbereitungs- und Abschluss-Ereignisse aus, an denen Shopware und Plugins hängen. Laut Quelltext 6.7.2.2, 6.7.15.1 und 6.6.10.30 schaltet system:update:prepare den Wartungsmodus der Verkaufskanäle nicht selbst ein. Beides gehört deshalb ausdrücklich in den Ablauf; die Reihenfolge steht in unserer Checkliste für Shopware-Updates. Ob sich ein Versionssprung überhaupt lohnt, beschreibt der Ratgeber Auf Shopware 6.7 wechseln oder bei 6.6 bleiben.
Was Suchmaschinen sehen
Google behandelt Serverfehler der Gruppe 5xx laut eigener Dokumentation so: Der Inhalt der Antwort wird ignoriert, das Crawling wird vorübergehend verlangsamt, bereits indexierte Adressen bleiben zunächst im Index. Halten die Fehler an, werden sie irgendwann entfernt (Google Search Central, „HTTP-Statuscodes, Netzwerk- und DNS-Fehler“, abgerufen am 30.10.2026).
Shopware antwortet allerdings nicht direkt mit 503, sondern leitet zuerst mit 307 um. Wie Google genau diese Kombination gewichtet, steht in der Dokumentation nicht. Unsere Einschätzung: Für eine Wartung von Minuten bis wenigen Stunden ist das unkritisch. Für mehrere Tage sollten Sie den Shop lieber nicht abschalten. Mehr zu den Grundlagen steht im Ratgeber Technisches SEO für Onlineshops.
Checkliste für eine Wartung
Kurz geprüft
- Alle betroffenen Verkaufskanäle bestimmt — oder
--allverwendet. - Eigene Adresse auf der Allowlist, Proxy-Konfiguration geprüft.
- Wartungsmodus eingeschaltet und
cache:clear:httpausgeführt, bei CDN auch dort geleert. - Aus einem fremden Netz geprüft: 307 auf
/maintenance, dort 503; bei Headless-Frontends 503 der Store API. - Arbeiten erledigt, Shop über die eigene freigegebene Adresse getestet.
- Wartungsmodus ausgeschaltet, Cache erneut geleert, Startseite und Kasse aus einem fremden Netz geprüft.
Der Schalter in der Administration ist nur die halbe Wartung. Wirksam ist sie erst, wenn ein Besucher ohne Freigabe wirklich 503 bekommt — in unserem Test mit Shopware 6.7.2.2 erst, nachdem die gesammelte Cache-Invalidierung gelaufen oder der HTTP-Cache geleert war.
Wie wir Shopware-Shops im laufenden Betrieb betreuen, beschreibt die Seite Shopware Support.
Häufige Fragen
- Schadet der Wartungsmodus dem Ranking?
- Für kurze Zeit halten wir das für unwahrscheinlich: Google behandelt Serverfehler wie 503 als Anlass, langsamer zu crawlen, und behält bereits indexierte Seiten zunächst. Dauern die Fehler an, entfernt Google die Adressen laut eigener Dokumentation irgendwann aus dem Index. Eine Wartung über Tage ist deshalb ein Risiko.
- Warum sehe ich den Shop, obwohl der Wartungsmodus an ist?
- Entweder steht Ihre IP-Adresse auf der Allowlist des Verkaufskanals, oder die Seite kommt noch aus dem HTTP-Cache. In unserem Test mit 6.7.2.2 war es der Cache: Die Seite kam weiter aus dem HTTP-Cache, bis die gesammelte Invalidierung gelaufen war. Leeren Sie ihn mit bin/console cache:clear:http und prüfen Sie aus einem fremden Netz.
- Kann ich die Wartungsseite gestalten?
- Ja. Ohne eigenes Layout zeigt Shopware eine Standardseite. In den Grundeinstellungen lässt sich ein Layout aus den Erlebniswelten als Wartungsseite festlegen.
- Ist die Administration im Wartungsmodus gesperrt?
- Nein. Die Sperre gilt für Anfragen an einen Verkaufskanal: die Storefront und die Store API. Die Administration und die Admin-API bleiben erreichbar, in unserem Test klappte die Anmeldung im Wartungsmodus normal.
- Brauche ich den Wartungsmodus für jedes Update?
- Nicht für jedes, aber für alles, was Datenbank, Plugins oder Theme verändert, während Kunden bestellen könnten. Ein Update ohne Wartungsmodus riskiert Bestellungen in einem halb aktualisierten Zustand.
