Shopware 6 Wartungsmodus & Entwickler-Modus richtig nutzen

von | Juni 6, 2026

Lesezeit: 1 Min · getestet auf Shopware 6.7.x

Kurz erklärt: Zwei Schalter, die oft verwechselt werden: Der Wartungsmodus nimmt einen Shop für Besucher offline (z. B. für Pflegearbeiten) und sitzt pro Verkaufskanal. Der Entwickler-Modus dagegen ist kein UI-Schalter, sondern eine Einstellung in der .env-Datei. Dieser Eintrag erklärt beide sauber.

Auf einen Blick

Wartungsmodus Pro Verkaufskanal → Reiter Allgemein → Status
Entwickler-Modus .env: APP_ENV=dev bzw. prod (kein UI-Schalter)
Wichtig Wartungsmodus ist nicht global – je Verkaufskanal
Getestet auf Shopware 6.7.x

Wartungsmodus aktivieren (pro Verkaufskanal)

Das ist ein häufiges Missverständnis: Es gibt keinen globalen Ein-Klick-Wartungsschalter. Der Wartungsmodus wird je Verkaufskanal gesetzt: Im linken Menü den Verkaufskanal wählen (z. B. „Storefront“) → Reiter Allgemein → Box Status → Schalter Wartungsmodus → Speichern.

Shopware 6.7: Verkaufskanal, Box „Status
Der Wartungsmodus sitzt pro Verkaufskanal – Reiter Allgemein → Box „Status“.

IP-Whitelist: trotz Wartung selbst reinkommen

Damit du (und z. B. die Agentur) den Shop während der Wartung weiter siehst, trägst du eure IP-Adressen in die Whitelist ein. Diese Besucher umgehen die Wartungsseite; alle anderen sehen das Wartungs-Layout. Hinweis bei Reverse-Proxy/Load-Balancer: Dann muss die echte Besucher-IP korrekt durchgereicht werden, sonst greift die Whitelist nicht.

Entwickler-/Dev-Modus (.env)

Der Entwickler-Modus ist keine Admin-Einstellung, sondern wird in der .env im Shopware-Wurzelverzeichnis gesetzt: APP_ENV=dev (Entwicklung, mit Symfony-Debug-Toolbar) oder APP_ENV=prod (Live). Nach dem Wechsel Cache leeren: bin/console cache:clear.

# .env
APP_ENV=prod   # Live
# APP_ENV=dev  # Entwicklung/Debugging

Wichtig: dev gehört nie auf ein Live-System – es zeigt Debug-Informationen und ist langsamer.

Storefront- & Admin-Watcher (für Entwicklung)

Für Theme- und Frontend-Entwicklung nutzt man statt wiederholter Builds die Watcher: den Storefront-Watcher (Hot Reload) und den Admin-Watcher. In Shopware 6.7 läuft die Administration auf Vite/Vue 3 (Node 20+) – die Admin-Builds sind dadurch deutlich schneller.

Aus der Praxis

  • „Mein ganzer Shop ist trotz Wartung online?“ – Wartungsmodus gilt pro Verkaufskanal. Betreibst du mehrere, jeden einzeln schalten.
  • Nach .env-Wechsel passiert nichts? Cache vergessen – bin/console cache:clear ist Pflicht.
  • Wartungsseite gestalten: Das Wartungs-Layout lässt sich anpassen, damit Besucher nicht auf einer nackten Seite landen.
  • CLI-Alternative für Wartung/Cache gibt es für Entwickler über bin/console.

Was sich seit Shopware 6.1/6.2 geändert hat

Funktional wenig: Wartungsmodus war schon immer pro Verkaufskanal, der Entwickler-Modus immer über die .env. Technisch ist 6.7 anders unter der Haube (Vite/Vue 3/Node 20) – relevant fürs Entwickler-Setup, nicht für die Bedienung.

Häufige Fragen

Gibt es einen globalen Wartungsschalter? Nein – immer pro Verkaufskanal.

Wo schalte ich den Entwickler-Modus im Admin ein? Gar nicht – das ist eine .env-Einstellung (APP_ENV).

Darf der Shop live im dev-Modus laufen? Nein – immer prod auf Live-Systemen.

Verwandte Einträge

Quellen

Teil des Konfigurations-Kurses · erstellt von great2gether · getestet auf Shopware 6.7.x.