Shopware

Was ist der Shopware Wartungsmodus?

Der Shopware Wartungsmodus ist eine Funktion, mit der ein Shop vorübergehend für Besucher gesperrt wird und stattdessen eine Wartungsseite anzeigt. Er dient dazu, Arbeiten am Shop wie Updates oder Umbauten kontrolliert durchzuführen, ohne dass Kunden eine fehlerhafte oder halbfertige Seite sehen. Berechtigte IP-Adressen können den Shop während der Wartung weiterhin aufrufen.

Der Wartungsmodus ist eine Standardfunktion in Shopware und betrifft die kundenseitige Storefront, während der Administrationsbereich weiter erreichbar bleibt. Ist er aktiv, sehen Besucher eine Wartungsseite statt des Shops. Damit das Team trotzdem testen kann, lassen sich einzelne IP-Adressen ausnehmen, die den Shop während der Wartung normal sehen. So bleibt kontrollierte Downtime möglich, ohne Kunden eine kaputte Seite zuzumuten.

Aspekt	Verhalten im Wartungsmodus
Storefront für Besucher	Gesperrt, es erscheint eine Wartungsseite
Administrationsbereich	Bleibt erreichbar, Arbeiten am Shop sind möglich
Ausgenommene IP-Adressen	Sehen den Shop weiterhin normal, etwa zum Testen
Typischer Zweck	Updates, Umbauten, Datenimporte, kontrollierte Downtime
Sichtbarkeit für Suchmaschinen	Wartungsseite signalisiert temporäre Nichtverfügbarkeit

Stand: Juni 2026. Beschreibung des Wartungsmodus bezieht sich auf Shopware 6.

Wer im Wartungsmodus was sieht

Im Wartungsmodus sehen normale Besucher eine Wartungsseite, während ausgenommene IP-Adressen den Shop weiter normal aufrufen können.

Wofür wird der Wartungsmodus genutzt?

Der Wartungsmodus kommt immer dann zum Einsatz, wenn am Shop gearbeitet wird und Kunden die Zwischenzustände nicht sehen sollen. Typische Anlässe:

Einspielen von Shopware-Updates oder Plugin-Aktualisierungen.
Größere Umbauten an Design, Struktur oder Erlebniswelten.
Umfangreiche Datenimporte, etwa Produkt- oder Preisaktualisierungen.
Kontrollierte, geplante Downtime mit klarer Kommunikation an die Kunden.

Wichtig ist, den Wartungsmodus geplant und kurz zu halten und die ausgenommenen IP-Adressen vorab zu hinterlegen, damit das Team die Arbeiten live prüfen kann, bevor der Shop wieder freigegeben wird.

Einordnung

Der Wartungsmodus ist kein Werkzeug für stille Dauerbaustellen, sondern für geplante, kurze Eingriffe. Wer ihn richtig nutzt, kombiniert ihn mit einer Staging-Umgebung, in der Updates vorab getestet werden, sodass die eigentliche Downtime im Livesystem so kurz wie möglich bleibt.

Philipp Foreman, Geschäftsführer onacy GmbH

Was sollte man beim Wartungsmodus beachten?

Eine längere Sperre wirkt sich auf Umsatz und auf die Wahrnehmung durch Suchmaschinen aus, weil die Wartungsseite eine temporäre Nichtverfügbarkeit signalisiert. Wartungsfenster sollten deshalb geplant, kurz gehalten und idealerweise in umsatzschwache Zeiten gelegt werden. Risikoreiche Änderungen gehören vorab in eine Test- oder Staging-Umgebung, damit der Livegang im Wartungsmodus nur noch das Einspielen und einen kurzen Funktionscheck umfasst.

Wie aktiviert man den Wartungsmodus in Shopware 6?

Der Wartungsmodus gilt in Shopware 6 jeweils für einen Verkaufskanal. In der Administration wird er so eingeschaltet:

Den betreffenden Verkaufskanal öffnen.
Im Bereich „Status“ den „Wartungsmodus“ aktivieren.
In der „Whitelist“ die IP-Adressen eintragen, die den Shop während der Wartung normal sehen sollen, etwa die des eigenen Teams.
Die Einstellungen speichern.

Läuft der Shop hinter einem Proxy, funktioniert die Whitelist laut Shopware-Dokumentation erst, wenn die IP des Proxys als vertrauenswürdig eingetragen ist, entweder in der .env-Datei unter TRUSTED_PROXIES oder in den PHP-Einstellungen. Für Deployments versetzt auf der Kommandozeile der Befehl bin/console sales-channel:maintenance:enable –all alle Verkaufskanäle in den Wartungsmodus, bin/console sales-channel:maintenance:disable –all hebt ihn wieder auf. Die offizielle Anleitung für Updates per Composer setzt genau diese Befehle vor und nach den Update-Schritten ein.

Häufige Fragen zum Shopware Wartungsmodus

Was ist der Shopware Wartungsmodus einfach erklärt?

Der Shopware Wartungsmodus sperrt den Shop vorübergehend für Besucher und zeigt stattdessen eine Wartungsseite. Er dient dazu, Arbeiten wie Updates oder Umbauten kontrolliert durchzuführen, ohne dass Kunden eine halbfertige Seite sehen. Ausgenommene IP-Adressen können den Shop während der Wartung weiterhin normal aufrufen, etwa zum Testen.

Wozu dient der Wartungsmodus in Shopware?

Der Wartungsmodus ermöglicht kontrollierte Downtime, während am Shop gearbeitet wird. Typische Anlässe sind das Einspielen von Updates, größere Umbauten oder umfangreiche Datenimporte. Die Storefront ist für Kunden gesperrt, der Administrationsbereich bleibt erreichbar. So lassen sich Änderungen vornehmen, ohne Kunden fehlerhafte Zustände zu zeigen.

Können Mitarbeiter den Shop im Wartungsmodus sehen?

Ja. Im Wartungsmodus lassen sich einzelne IP-Adressen ausnehmen, die den Shop weiterhin normal aufrufen können. So kann das Team Änderungen live prüfen, während normale Besucher die Wartungsseite sehen. Zusätzlich bleibt der Administrationsbereich erreichbar, sodass die eigentlichen Arbeiten am Shop ungehindert möglich sind.

Schadet der Wartungsmodus dem SEO?

Kurze, geplante Wartungsfenster sind in der Regel unkritisch, da die Wartungsseite eine temporäre Nichtverfügbarkeit signalisiert. Problematisch wird es bei langen oder häufigen Sperren. Deshalb sollte das Wartungsfenster kurz gehalten und in umsatzschwache Zeiten gelegt werden, und risikoreiche Änderungen sollten vorab in einer Staging-Umgebung getestet werden.

Lässt sich der Shopware Wartungsmodus per Kommandozeile schalten?

Ja. Mit dem Befehl bin/console sales-channel:maintenance:enable –all werden alle Verkaufskanäle in den Wartungsmodus versetzt, mit sales-channel:maintenance:disable –all wird er wieder beendet. Shopware sieht diese Befehle in seiner Update-Anleitung für Composer vor. In der Administration wird der Wartungsmodus dagegen je Verkaufskanal im Bereich Status aktiviert, inklusive Whitelist für freigegebene IP-Adressen.