Shopware Update 2026: Schritt für Schritt, mit echten Messungen

Shopware Update 2026: Schritt für Schritt, mit echten Messungen

Ein Shopware Update ist in der Theorie drei Befehle lang. Version in der composer.json hochsetzen, composer update, bin/console system:update:finish. Fertig. Wir haben das am 21.11.2026 an zwei frischen Wegwerf-Shops durchgespielt, einmal als kleines Update innerhalb der 6.7-Linie (6.7.13.1 → 6.7.16.1) und einmal als Sprung über die Hauptversion (6.6.10.32 → 6.7.16.1). Beide Updates waren am Ende erfolgreich. Die reine Rechenzeit lag jeweils unter 15 Sekunden.

Interessant ist, was dazwischen passierte. Zwischen dem Austausch des Codes und dem Abschluss der Migrationen lieferte unser Shop HTTP 500, und zwar auch dann, als der Wartungsmodus eingeschaltet war. Der Wartungsmodus selbst wirkte erst, nachdem wir den Cache geleert hatten. Ein Plugin, das ausdrücklich nur bis 6.7.13 freigegeben war, lief nach dem Update einfach weiter. Beim Sprung von 6.6 auf 6.7 brach Composer mit einem Fehler ab, den man nur mit einem Befehl behebt, der in kaum einer Kurzanleitung steht.

Dieser Artikel zeigt den kompletten Ablauf mit allen Messwerten: Backup, Update, Wartungsfenster, Rollback und den Major-Sprung. Keine Kundendaten, keine Produktivsysteme. Alles lief in Testinstanzen, die danach gelöscht wurden.

Shopware Update: die Kurzfassung

gemessen
Kleines Update6.7.13.1 → 6.7.16.1
composer update (18 Pakete)6,9 s
system:update:finish3,0 s, 146 MB RAM
Migrationen848 → 894 (+46)
Tabellen252 → 256
Storefront zwischen Code und MigrationHTTP 500
Datenbank-Dump vorher2,0 MB (0,2 MB gezippt), 0,39 s
Kompletter Rollback inkl. Dump-Import11,8 s
Major-Update6.6.10.32 → 6.7.16.1
composer update -W63 Paketoperationen, 7,2 s, Abbruch ohne Recipe-Update
Migrationen Major722 → 919 (+197), 230 → 256 Tabellen
system:update:finish Major4,7 s
Methodik: Ubuntu-Server mit 12 vCPU und 22 GB RAM, PHP 8.3.6 CLI, Composer 2.10.3, MariaDB 11.8.9 im Docker-Container nur auf 127.0.0.1. Shops jeweils frisch per composer create-project shopware/production und system:install --basic-setup installiert, APP_ENV=prod. HTTP-Messungen mit curl gegen den eingebauten PHP-Webserver. Die Absolutzeiten gelten für leere Testshops ohne Produkte; die Reihenfolge der Zustände (wann 500, wann 503, wann 200) ist das, worauf es ankommt.

Welche Shopware-Version habe ich eigentlich?

Bevor du ein Shopware Update planst, musst du wissen, wo du stehst. Auf der Kommandozeile geht das am schnellsten:

php bin/console --version
# Shopware 6.7.13.1 (env: prod, debug: false)

In der Administration steht die Version unten links im Menü bzw. unter Einstellungen → System → Shopware-Update. Composer verrät dir zusätzlich, welche Pakete hinterherhängen:

composer outdated "shopware/*" -D
# shopware/administration 6.7.13.1 ! 6.7.16.1
# shopware/core           6.7.13.1 ! 6.7.16.1
# shopware/elasticsearch  6.7.13.1 ! 6.7.16.1
# shopware/storefront     6.7.13.1 ! 6.7.16.1

Ein Detail, das man in unserer Messung gut sehen konnte: Ein einfaches composer update aktualisiert nichts. Die composer.json eines Shopware-Projekts pinnt shopware/core auf eine exakte Version ("shopware/core": "v6.7.13.1"). Ein Trockenlauf meldete deshalb „Nothing to modify in lock file“, obwohl drei neuere Versionen verfügbar waren. Das ist Absicht. Updates passieren nicht versehentlich.

Wie oft erscheinen Shopware-Updates?

Laut Packagist erschienen im Jahr 2026 bis zum 21.11. 25 Versionen der 6.7-Linie und 22 Patch-Versionen für 6.6.10. Shopware veröffentlicht grob einmal im Monat ein Minor-Release mit neuen Funktionen (z. B. 6.7.15.0), dazwischen Patches mit Fehler- und Sicherheitskorrekturen (6.7.15.1). Die vierstellige Nummer liest sich so:

StelleBeispielBedeutung
66.7.16.1Produktgeneration, ändert sich praktisch nie
76.7.16.1Major-Version, Breaking Changes für Plugins und Themes
166.7.16.1Minor-Release, neue Funktionen, abwärtskompatibel
16.7.16.1Patch, Fehler- und Sicherheitskorrekturen

Die Ziffer, die Shopware „Major“ nennt, ist also die zweite. Ein Sprung von 6.6 auf 6.7 ist ein großes Update, ein Sprung von 6.7.13 auf 6.7.16 ein kleines, auch wenn drei Zahlen dazwischen liegen.

Bekommt Shopware 6.6 noch Updates?

Ja. Die Version 6.6.10.32 erschien am 18.11.2026. Shopware pflegt laut eigener Release-Policy die aktuelle Linie und die letzte Version der Vorgängerlinie. Wer auf 6.6 steht, sollte also zuerst innerhalb von 6.6 auf den neuesten Patch gehen und den Sprung auf 6.7 als eigenes Projekt planen. Genau das haben wir im zweiten Teil dieses Artikels gemacht.

Vor dem Update: Backup, das man auch zurückspielen kann

Datenbank und Code-Ordner wandern in einen gesicherten Tresor, ein Pfeil zurück steht für den Rollback

Ein Shopware Update ändert zwei Dinge gleichzeitig: den Code (Composer, vendor/) und die Datenbank (Migrationen). Ein Backup muss beides abdecken, sonst ist es keins.

Datenbank: Ein Dump mit --single-transaction sperrt bei InnoDB-Tabellen nichts und ist deshalb auch im laufenden Shop möglich.

mariadb-dump --single-transaction -u shopuser -p shopware > vor-update.sql
gzip -k vor-update.sql

Unser leerer Testshop ergab einen Dump von 2,0 MB in 0,39 Sekunden, gezippt 0,2 MB. Ein echter Shop mit Bestellhistorie ist um Größenordnungen größer. Miss das bei dir einmal vorher, dann weißt du, wie lange das Wartungsfenster mindestens sein muss. Alles zu Dump-Varianten, Verschlüsselung und Restore-Tests steht im Artikel MySQL Backup.

Code: Am saubersten ist ein Git-Repository über das Projekt. Die mitgelieferte .gitignore schließt vendor/, .env.local, public/media und public/theme bereits aus. Committet werden also nur composer.json, composer.lock, symfony.lock, die Konfiguration und eigene Plugins. Damit ist der Code-Stand einer Version genau ein Commit.

git add -A && git commit -m "Stand vor Update auf 6.7.16.1"

Medien und Umgebung: public/media, files/ und .env.local stehen nicht in Git. Die müssen ins normale Datei-Backup. Wie man das so organisiert, dass ein einzelner Ausfall nicht alles mitnimmt, steht in der 3-2-1-Backup-Strategie.

Die wichtigste Regel: Ein Backup, dessen Restore du nie geübt hast, ist eine Hoffnung. Wir haben den Rollback weiter unten tatsächlich durchgespielt und gestoppt.

Das kleine Update: 6.7.13.1 auf 6.7.16.1

Ausgangslage: frisch installierter Shop auf 6.7.13.1, 848 Migrationen, 252 Tabellen, Storefront und Admin liefern HTTP 200. Dazu ein selbst gebautes Mini-Plugin GmTestPin, dessen composer.json absichtlich nur "shopware/core": "~6.7.13.0" erlaubt. Das simuliert eine Erweiterung, die der Hersteller noch nicht für neuere Versionen freigegeben hat.

Schritt 1: Version in Composer anheben

composer require "shopware/core:6.7.16.1" --no-update
composer update "shopware/*" --with-all-dependencies --no-scripts

--no-update schreibt nur die composer.json, ohne sofort aufzulösen. Der zweite Befehl aktualisiert alle Shopware-Pakete und erlaubt Composer, die Abhängigkeiten mitzuziehen. Ergebnis bei uns: 18 Paketoperationen in 6,9 Sekunden, darunter neben den vier Shopware-Paketen auch twig/twig 3.28 → 3.29 und symfony/mcp-bundle 0.11 → 0.15. Composer meldete am Ende „No security vulnerability advisories found“.

Im Git-Diff tauchten danach drei geänderte Dateien auf: composer.json, composer.lock und public/.htaccess. Die Änderung an der .htaccess war nur ein fehlender Zeilenumbruch am Dateiende. Das klingt banal, ist aber genau die Art Änderung, die bei einem Server mit selbst angepasster .htaccess einen Merge-Konflikt oder ein stilles Überschreiben erzeugt. Nach jedem Update einmal git diff lesen.

Schritt 2: der gefährliche Moment

Jetzt liegt neuer Code auf der Platte, die Datenbank ist aber noch auf dem alten Stand. Wir haben genau in diesem Zustand die Storefront aufgerufen:

storefront-mitten 500 1017
<title>An Error Occurred: Internal Server Error

Im Log stand der Grund:

CRITICAL: Uncaught PHP Exception Doctrine\DBAL\Exception\InvalidFieldNameException:
"Unknown column 'language.translation_auto_update' in 'SELECT'"

Der neue Code erwartet eine Spalte, die erst eine der 46 neuen Migrationen anlegt. Das ist kein Bug, sondern die normale Folge davon, dass Code und Schema kurz nicht zusammenpassen. Es heißt aber: Jeder Besucher, der in diesem Moment kommt, sieht eine Fehlerseite. Wie lange dieser Moment dauert, hängt nur davon ab, wie schnell du von Schritt 1 zu Schritt 3 kommst.

Auch system:update:prepare ändert daran nichts. Wir haben es ausgeführt und danach erneut gemessen: weiterhin HTTP 500. Der Befehl löst Vorbereitungs-Events aus (Plugins können sich dort einhängen), er migriert nichts.

Schritt 3: Update abschließen

php bin/console system:update:finish

Dieser Befehl führt die Migrationen aus, aktualisiert Plugins, kopiert die Assets aller Bundles nach public/bundles und leert den Cache. Bei uns: 3,0 Sekunden, Spitzenwert 146 MB RAM. Danach standen 894 Migrationen und 256 Tabellen in der Datenbank.

storefront-nach 200 0.56 s 78873 Bytes
danach: 0.008 s, 0.007 s, 0.006 s
admin 200
Shopware 6.7.16.1 (env: prod, debug: false)

Der erste Aufruf nach dem Update dauerte 0,56 Sekunden, weil Container und Templates neu kompiliert werden. Die folgenden lagen bei 6 bis 8 Millisekunden. Wer nach dem Update sofort einmal selbst die Startseite und ein paar Kategorien aufruft, nimmt diesen Kaltstart den echten Kunden ab.

Das Video von Shop Studio stammt aus 2022 und zeigt den Weg über die Administration. Der Ablauf in der Oberfläche hat sich seitdem verändert, das Prinzip (Backup, Plugin-Kompatibilität prüfen, Update, testen) ist gleich geblieben.

Das Plugin, das nicht hätte laufen dürfen

Nach dem Update auf 6.7.16.1 meldete plugin:list unser Testplugin weiterhin als installiert und aktiv, obwohl es per composer.json nur ~6.7.13.0 erlaubt. Kein Hinweis, keine Warnung im Update-Output. Erst als wir es einmal deaktiviert und wieder aktivieren wollten, kam die Prüfung:

Could not activate plugin, got 1 failure(s).
Required plugin/package "shopware/core ~6.7.13.0" does not match installed version == 6.7.16.1.

Das heißt in der Praxis: Ein laufendes Plugin wird beim Update nicht auf Kompatibilität geprüft. Ob es mit der neuen Version funktioniert, merkst du erst, wenn es kaputtgeht, oder wenn du es irgendwann neu aktivieren musst und das plötzlich nicht mehr geht. Unser Testplugin war leer, deshalb lief es. Ein echtes Plugin, das eine geänderte Core-Klasse überschreibt, hätte stattdessen eine Fehlerseite erzeugt.

Die Konsequenz: Prüf vor dem Update jedes Plugin einzeln. Im Store steht bei jeder Erweiterung, bis zu welcher Version sie freigegeben ist. Für eigene Plugins lohnt der Blick in deren composer.json. Wie man Plugins so baut, dass sie Updates überstehen, zeigt Shopware Plugin entwickeln.

Wartungsmodus: was er tut und was nicht

Ein Shop-Eingang mit Absperrung und Pylonen, dahinter arbeiten Techniker an Serverschränken

Shopware hat einen Wartungsmodus pro Verkaufskanal. Einschalten geht in der Administration oder per Konsole:

php bin/console sales-channel:maintenance:enable --all
php bin/console sales-channel:maintenance:disable --all

Hier kam unser zweiter Fund. Direkt nach maintenance:enable haben wir die Startseite aufgerufen: HTTP 200, die vollständige Shopseite, 78.031 Bytes. Byte für Byte dieselbe Antwort wie vorher. Die Seite kam aus dem HTTP-Cache, und der wusste nichts vom Wartungsmodus. Erst nach cache:clear verhielt sich der Shop wie erwartet:

/              → 307 Weiterleitung auf /maintenance?redirectTo=frontend.home.page
/maintenance   → 503 Service Unavailable
/admin         → 200 (Administration bleibt erreichbar)
/api/...       → 401 ohne Token (API bleibt aktiv)

Die 503 auf der Wartungsseite ist richtig so. Sie sagt Suchmaschinen, dass die Störung vorübergehend ist, und sorgt dafür, dass die Seite nicht als Inhalt gecacht wird. Für Google ist ein kurzer 503 unproblematisch, eine 200 mit „Wir sind gleich zurück“ dagegen ein schlechtes Signal. Mehr zu Shopware und Suchmaschinen steht in Shopware SEO.

Wer bestimmte Besucher (sich selbst, die Agentur) trotzdem in den Shop lassen will, trägt deren IP-Adressen in der Administration beim Verkaufskanal als Ausnahme ein.

Hilft der Wartungsmodus während des Updates?

Das war die eigentliche Frage. Wir haben das Update ein zweites Mal durchgespielt, diesmal mit eingeschaltetem Wartungsmodus und einer Schleife, die alle 0,5 Sekunden Startseite und Wartungsseite abfragte. Gekürzt sah das Protokoll so aus:

Anzahl  Startseite  /maintenance   Phase
   4      307         503          Wartung aktiv, alter Code
   2      500         500          composer install tauscht vendor/ aus
  12      307         503          neuer Code, finish läuft, Cache geleert
   7      200         302          Wartung aus, Update fertig

Zwei Abfragen fielen in den Moment, in dem Composer das vendor/-Verzeichnis austauschte. Beide lieferten HTTP 500, auch die Wartungsseite. Dazwischen lag eine Lücke von rund drei Sekunden, in der eine Abfrage überhaupt erst nach langer Wartezeit zurückkam. Der Wartungsmodus ist Teil von Shopware. Wenn Shopware selbst gerade nicht lauffähig ist, kann er nichts ausliefern.

Nach dem Codeaustausch, also während system:update:finish lief, griff der Wartungsmodus zuverlässig: Wir haben keine 500 mehr gesehen. Der Fehler aus Schritt 2 (fehlende Spalte) war für Besucher damit unsichtbar.

Was daraus folgt:

  1. Wartungsmodus einschalten und danach cache:clear, sonst liefert der Cache weiter den normalen Shop aus.
  2. Für den Codeaustausch selbst schützt der Wartungsmodus nicht. Wer null Fehlerseiten will, braucht eine Wartungsseite vor PHP, also im Webserver (nginx, Apache, Caddy) oder im Load Balancer. Ein einfacher Weg: eine statische HTML-Datei, die nginx mit 503 ausliefert, solange eine Schalterdatei existiert.
  3. Der sauberste Weg ist, den Code gar nicht im laufenden Verzeichnis zu ändern: neues Release in einem eigenen Ordner bauen, dort composer install ausführen, dann einen Symlink umhängen. So arbeiten Deployment-Werkzeuge wie Deployer. Shopware bietet dafür außerdem das Paket shopware/deployment-helper an. Das haben wir für diesen Artikel nicht getestet.

Rollback: wie schnell kommt man zurück?

Paketkisten, die über leuchtende Abhängigkeitslinien zu einem Baum verbunden sind

Angenommen, nach dem Update funktioniert etwas Wichtiges nicht mehr. Wir haben zwei Rückwege gemessen.

Nur den Code zurückdrehen

git checkout HEAD~1 -- composer.json composer.lock symfony.lock
composer install --no-scripts

Danach lief wieder 6.7.13.1, gegen eine Datenbank mit den 894 Migrationen von 6.7.16.1. Die Storefront lieferte trotzdem HTTP 200, vor und nach dem Leeren des Caches. Das hat einen Grund: Shopware-Migrationen sind so geschrieben, dass alter Code mit einem neueren Schema weiterlaufen kann. Neue Spalten stören alten Code nicht, er fragt sie einfach nicht ab. Entfernt werden Spalten und Tabellen erst in einem späteren Schritt, den Shopware „destruktive Migrationen“ nennt.

Das ist ein schneller Notausgang, aber kein Zustand für länger. Alte Daten-Indizes, Plugin-Zustände und neue Datensätze passen dann nicht mehr sicher zusammen. Für einen Notfall am Freitagabend reicht er.

Code und Datenbank zurück

git checkout HEAD~1 -- composer.json composer.lock symfony.lock
composer install --no-scripts
mariadb -e "DROP DATABASE shopware; CREATE DATABASE shopware"
mariadb shopware < vor-update.sql
php bin/console cache:clear
php bin/console assets:install

Gesamtzeit vom ersten Befehl bis HTTP 200: 11,8 Sekunden, danach wieder exakt 848 Migrationen. Bei einem echten Shop dominiert hier der Dump-Import. Ein Gigabyte SQL dauert je nach Server ein paar Minuten, nicht Sekunden.

Der Preis: Alles, was zwischen Backup und Rollback in der Datenbank passiert ist, ist weg. Neue Bestellungen, neue Kundenkonten, Lageränderungen. Genau deshalb ist der Wartungsmodus vor dem Backup sinnvoll und nicht erst danach. Wenn in der Wartungszeit keine Bestellung reinkommen kann, kann beim Rollback auch keine verloren gehen.

Das große Update: 6.6 auf 6.7

Eine Brücke zwischen zwei schwebenden Inseln, über die Puzzleteile getragen werden, von denen nicht alle passen

Ein Major-Update ist eine andere Liga. Zwischen 6.6 und 6.7 hat Shopware unter anderem Doctrine DBAL von Version 3 auf 4 gehoben, die Administration auf Vue 3 vollständig umgestellt, den Cache überarbeitet und Plugin-Schnittstellen entfernt, die vorher als veraltet markiert waren. Alles das steht in der Datei UPGRADE-6.7.md im Shopware-Repository. Wer eigene Plugins oder ein eigenes Theme hat, muss diese Datei lesen. Für Händler ohne eigene Erweiterungen ist die wichtigere Frage, ob alle gekauften Plugins für 6.7 freigegeben sind.

Unser Test: ein frischer Shop auf 6.6.10.32 (722 Migrationen, 230 Tabellen), ohne Plugins.

Der erste Versuch scheitert

composer require "shopware/core:6.7.16.1" --no-update
composer update "shopware/*"

Composer verweigerte das Update mit einer langen Liste. Der entscheidende Satz:

shopware/administration[v6.7.8.0, ..., v6.7.16.1] require doctrine/dbal ~4.4.0
-> found doctrine/dbal[4.4.0, ..., 4.4.5] but the package is fixed to 3.10.7 (lock file version)

Ohne --with-all-dependencies darf Composer nur die genannten Pakete anfassen, und DBAL 3 passt nicht zu Shopware 6.7. Also mit -W:

composer update "shopware/*" -W

Diesmal 63 Paketoperationen in 7,2 Sekunden: DBAL 3.10.7 → 4.4.5, vier Pakete entfernt (doctrine/event-manager, lcobucci/clock, padaliyajay/php-autoprefixer, tecnickcom/tcpdf), neue hinzugekommen. Und dann der Abbruch am Ende:

Script assets:install returned with error code 255
[critical] Uncaught Exception: You have requested a non-existent parameter "shopware.service_registry.url".

Der Code war schon 6.7, die Konfiguration des Projekts aber noch 6.6. In der config/bundles.php fehlte ein Bundle, das es in 6.6 noch nicht gab. Ab diesem Punkt startete nicht einmal mehr bin/console.

Die Lösung: Symfony-Recipes aktualisieren

Das Projekt-Template shopware/production arbeitet mit Symfony Flex. Dateien wie bundles.php, public/index.php, .env und die Build-Skripte kommen aus sogenannten Recipes. Composer aktualisiert die Pakete, aber nicht automatisch die Dateien, die einmal aus einem Recipe ins Projekt kopiert wurden. Das muss man ausdrücklich anstoßen:

composer recipes            # zeigt: shopware/core (update available)
git add -A && git commit -m "composer auf 6.7"   # Recipes verlangen einen sauberen Arbeitsbaum
composer recipes:update shopware/core
composer recipes:update shopware/administration
composer recipes:update shopware/storefront

Composer wollte die Recipes erst aktualisieren, nachdem alle Änderungen committet waren („Please commit or stash them and try again“). Danach meldete es dreimal „Recipe updated“. Das Ergebnis im Diff: 10 Dateien, unter anderem

  • config/bundles.php: neue Zeile Shopware\Core\Service\Service::class, genau das fehlende Bundle,
  • public/index.php: 10 Zeilen geändert,
  • bin/build-administration.sh und bin/build-storefront.sh: deutlich umgebaut,
  • .env: die veraltete Variable MAILER_URL entfernt.

Danach lief bin/console wieder und meldete Shopware 6.7.16.1. Hast du an einer dieser Dateien selbst etwas geändert, zeigt recipes:update Konflikte wie ein Git-Merge an. Deshalb lohnt es sich, eigene Anpassungen nicht in Recipe-Dateien zu schreiben, sondern in eigene Konfigurationsdateien.

Abschluss und Ergebnis

php bin/console system:update:finish

4,7 Sekunden, danach 919 Migrationen (+197) und 256 Tabellen (+26). Storefront und Administration lieferten HTTP 200. Im Composer-Output standen zuvor drei Hinweise auf Funktionen, die mit 6.8 entfallen (purge_all, enable_queue_stats_worker, http_cache). Wer die liest, weiß jetzt schon, was beim nächsten großen Update in der eigenen Konfiguration fällig wird.

Wichtig: Unser Test ist der beste denkbare Fall. Ein leerer Shop ohne Plugins, ohne eigenes Theme, ohne angepasste Konfiguration. Bei einem echten Shop kommt der eigentliche Aufwand danach: Plugins auf 6.7-Versionen bringen, das Theme neu bauen, Twig-Templates gegen die geänderten Blöcke prüfen, Zahlungs- und Versandwege testen. Das dauert Tage, nicht Sekunden. Was so ein Projekt kostet, wenn man es vergibt, steht in Was kostet Shopware 6.

Der komplette Ablauf als Checkliste

Aus unseren Messungen ergibt sich diese Reihenfolge für ein Shopware Update auf einem eigenen Server:

Vorher (Tage vorher)

  1. Aktuelle Version prüfen: php bin/console --version.
  2. Zielversion festlegen. Bei Patches: die neueste. Bei Minor-Releases: Changelog lesen. Bei Major: UPGRADE-6.x.md lesen.
  3. Alle Plugins auf Freigabe für die Zielversion prüfen. Nicht freigegebene Plugins blockieren das Update nicht, sie gehen nur hinterher kaputt.
  4. Das Update auf einer Kopie (Staging) durchspielen. Die Datenbank dafür aus einem aktuellen Dump einspielen.
  5. Ein ruhiges Zeitfenster wählen, nicht Freitagabend und nicht während einer Rabattaktion.

Im Wartungsfenster

php bin/console sales-channel:maintenance:enable --all
php bin/console cache:clear                      # sonst wirkt die Wartung nicht
mariadb-dump --single-transaction shopware > vor-update.sql
git add -A && git commit -m "vor Update"

composer require "shopware/core:6.7.16.1" --no-update
composer update "shopware/*" -W --no-scripts
# nur bei Major: composer recipes:update shopware/core (+ administration, storefront)
php bin/console system:update:finish

php bin/console sales-channel:maintenance:disable --all
php bin/console cache:clear

Danach

  1. Startseite, Kategorie, Produktseite, Warenkorb, Checkout bis zur Zahlungsauswahl selbst durchklicken.
  2. Admin-Login und eine Bestellansicht öffnen.
  3. Das Log in var/log/ auf CRITICAL durchsuchen.
  4. Nachrichten-Warteschlange prüfen: Läuft messenger:consume noch? Nach einem Update müssen Worker neu gestartet werden, weil sie sonst mit altem Code im Speicher weiterlaufen. Bei einem systemd-Dienst reicht systemctl restart (wie man so einen Dienst anlegt, steht in systemd Service erstellen).
  5. Den Stand committen.

Update über die Administration statt über die Konsole?

Shopware hat in der Administration einen Bereich für Updates. Seit Shopware die Installation auf Composer umgestellt hat, läuft das Update ohne Kommandozeile über den Shopware Web Installer, eine einzelne Datei shopware-installer.phar.php, die man in public/ legt und im Browser aufruft. Er führt im Hintergrund dieselben Composer-Schritte aus.

Den Web Installer haben wir für diesen Artikel nicht getestet. Er ist für Hosting-Pakete ohne SSH-Zugang gedacht. Die Einschränkungen ergeben sich aus dem Prinzip: Composer braucht Arbeitsspeicher und Zeit, und beides ist bei günstigem Shared Hosting oft knapp begrenzt (PHP memory_limit, max_execution_time). Bricht der Prozess mitten im Codeaustausch ab, stehst du in genau dem Zustand aus Schritt 2, nur ohne Konsole, um ihn zu reparieren. Wer einen eigenen Server betreibt, ist mit der Konsole besser dran. Wie man so einen Server aufsetzt, zeigt Linux Server einrichten.

Typische Fehler beim Shopware Update

„Nothing to modify in lock file“: Die Version in der composer.json ist exakt gepinnt. Erst mit composer require "shopware/core:NEUE_VERSION" --no-update anheben.

„the package is fixed to … (lock file version)“: Eine Abhängigkeit muss mitwachsen. Mit -W (--with-all-dependencies) erlauben.

„non-existent parameter“ oder „Class not found“ direkt nach einem Major-Update: Die Recipes sind noch auf dem alten Stand. composer recipes, dann composer recipes:update für die Shopware-Pakete.

HTTP 500 mit „Unknown column“ im Log: Code ist neu, Datenbank noch alt. system:update:finish ausführen.

Wartungsmodus aktiv, Shop trotzdem sichtbar: HTTP-Cache. cache:clear.

Plugin lässt sich nach dem Update nicht mehr aktivieren: Es ist nicht für die neue Version freigegeben. Update des Plugins einspielen oder auf die vorherige Shopware-Version zurück.

Admin sieht nach dem Update kaputt aus: Meist ein Browser-Cache mit alten JavaScript-Dateien. Hart neu laden. Wenn es bleibt: php bin/console assets:install und bei eigenen Erweiterungen die Administration neu bauen (bin/build-administration.sh).

FAQ

Wie mache ich ein Shopware 6 Update?

Mit SSH-Zugang: Backup von Datenbank und Code, Wartungsmodus an, cache:clear, die Zielversion mit composer require "shopware/core:VERSION" --no-update setzen, composer update "shopware/*" -W, dann php bin/console system:update:finish, Wartungsmodus aus, cache:clear, testen. Ohne SSH über den Shopware Web Installer. Unser kleines Update dauerte in der reinen Rechenzeit unter 10 Sekunden.

Wie lange dauert ein Shopware Update?

Die reine Rechenzeit ist kurz: 6,9 Sekunden composer update plus 3,0 Sekunden Migrationen beim kleinen Update, 7,2 plus 4,7 Sekunden beim Sprung von 6.6 auf 6.7, jeweils in einem leeren Testshop. Bei einem echten Shop kommen Backup, Dump-Größe, Plugin-Updates, Theme-Build und vor allem das Testen dazu. Plane für ein Patch-Update eine Stunde, für ein Major-Update mehrere Tage.

Ist der Shop während des Updates offline?

Er sollte es sein. In unserer Messung lieferte der Shop zwischen Codeaustausch und Migration HTTP 500. Der Wartungsmodus verdeckt das ab dem Moment, in dem der neue Code vollständig liegt, aber nicht während Composer das vendor/-Verzeichnis austauscht. Ein echter Null-Ausfall braucht eine Wartungsseite im Webserver oder einen Release-Wechsel per Symlink.

Kann ich ein Shopware Update rückgängig machen?

Ja, wenn du vorher gesichert hast. Code per Git auf den alten Stand, composer install, Datenbank aus dem Dump zurückspielen, Cache leeren. Bei uns dauerte das 11,8 Sekunden. Nur den Code zurückzudrehen funktionierte im Test ebenfalls (alter Code lief auf dem neuen Schema), ist aber nur ein Notausgang. Bestellungen aus der Zeit zwischen Backup und Rollback gehen beim Datenbank-Rollback verloren.

Muss ich jedes Patch-Update einspielen?

Sicherheitsrelevante Patches ja, und zwar zeitnah. Shopware veröffentlicht Sicherheitskorrekturen in Patch-Versionen; wer mehrere Monate hinterherhängt, hat bekannte Lücken offen. Für Shops, die vorübergehend nicht aktualisieren können, bietet Shopware ein kostenloses Security-Plugin an, das einzelne Lücken ohne Versionswechsel schließt. Das ersetzt das Update aber nicht dauerhaft.

Kann ich Versionen überspringen?

Innerhalb einer Linie ja: Wir sind direkt von 6.7.13.1 auf 6.7.16.1 gegangen, die Migrationen der dazwischenliegenden Versionen liefen alle in einem Durchgang. Bei Major-Updates führt der Weg über den letzten Stand der alten Linie, also erst auf das neueste 6.6.10.x, dann auf 6.7.

Was ist der Unterschied zwischen system:update:prepare und system:update:finish?

prepare löst Ereignisse aus, mit denen sich Plugins auf ein Update vorbereiten können, und ändert sonst nichts Sichtbares. In unserem Test lieferte der Shop nach prepare weiterhin HTTP 500. finish führt die Migrationen aus, aktualisiert Plugins, installiert die Assets und leert den Cache. Ohne finish ist das Update nicht fertig.

Warum funktioniert mein Plugin nach dem Update nicht mehr?

Weil Shopware aktive Plugins beim Update nicht auf Kompatibilität prüft. Unser Testplugin war nur bis 6.7.13 freigegeben und lief nach dem Update auf 6.7.16.1 trotzdem weiter. Erst beim erneuten Aktivieren kam die Ablehnung. Vor jedem Update daher die Freigaben aller Erweiterungen prüfen und deren Updates mit einspielen.

Brauche ich für das Shopware Update eine Agentur?

Für Patch- und Minor-Updates in einem Shop ohne eigene Programmierung reicht die Checkliste oben, wenn du SSH-Zugang hast und den Rollback einmal geübt hast. Bei einem Major-Update mit eigenen Plugins, angepasstem Theme oder Schnittstellen zu Warenwirtschaft und Versand ist Unterstützung sinnvoll. Der Aufwand steckt dann in den Anpassungen, nicht im Update-Befehl.

Welche PHP-Version brauche ich für Shopware 6.7?

Shopware 6.7 läuft laut composer.json des Cores mit PHP 8.2 bis 8.5. Wir haben mit PHP 8.3.6 getestet. Laut den aktuellen Upgrade-Notizen wird Shopware 6.8 PHP 8.5 voraussetzen. Wer jetzt auf 6.7 geht, kann also die PHP-Version gleich mit planen.

Fazit

Ein Shopware Update besteht aus drei Befehlen, und die eigentliche Rechenzeit lag in unseren Tests bei unter 15 Sekunden, auch beim Sprung über eine Hauptversion. Die Risiken stecken an Stellen, die keine Fehlermeldung erzeugen. Der Wartungsmodus wirkt erst nach cache:clear. Während Composer den Code austauscht, schützt er gar nicht, auch die Wartungsseite selbst liefert dann HTTP 500. Ein nicht freigegebenes Plugin läuft nach dem Update stillschweigend weiter. Und beim Major-Update scheitert Composer, bis man die Recipes aktualisiert, einen Schritt, den kaum eine Kurzanleitung nennt.

Wer das weiß, macht ein Update in einer ruhigen Stunde: Wartung an, Cache leeren, Dump ziehen, committen, aktualisieren, abschließen, durchklicken. Und hat einen Rollback, der nachweislich in Sekunden funktioniert.

Weiterlesen: Wie ein Shop überhaupt aufgesetzt wird und welche zwei Installationsfehler trotz Erfolgsmeldung auftreten, steht in Shopware Installation. Wie man Datenbank-Backups so anlegt, dass der Restore im Notfall funktioniert, zeigt MySQL Backup. Und wer seinen Code ohnehin in Git hat, findet die Befehle für Commits, Diffs und Rückwege in der Git-Befehle-Liste.