1. Vorbereitung: Testumgebung und Backup
Shopware rät, ein Update nur mit entsprechender Erfahrung selbst zu starten und sonst die Partneragentur einzubinden. Am sichersten testest du das Update zuerst in einer Testumgebung, also einer Kopie deines Shops.
Vor dem Update des Live-Systems brauchst du laut Doku in jedem Fall ein Backup, auch wenn das Update im Testsystem schon geklappt hat. Wichtig: Shopware erstellt selbst keine Backups. Die richtest du auf dem Server ein oder klärst mit deinem Hoster, ob er sie übernimmt.
Prüfe außerdem die Systemvoraussetzungen der Zielversion. Sie ändern sich mit größeren Versionssprüngen, zum Beispiel bei PHP, MySQL oder MariaDB.
- Testumgebung anlegen und das Update dort ausprobieren.
- Backup von Dateien und Datenbank des Live-Shops erstellen.
- Systemvoraussetzungen der Zielversion prüfen.
- Erweiterungen auf Kompatibilität prüfen (nächster Abschnitt).
2. Erweiterungen auf Kompatibilität prüfen
Die Doku nennt diesen Punkt ausdrücklich wichtig: Vor dem Update müssen alle installierten Erweiterungen aktuell und kompatibel sein. Inkompatible Erweiterungen löschst du vorher, ob aktiv oder nicht. Unter Meine Erweiterungen darf keine inkompatible Erweiterung mehr auftauchen, sonst kann das Update scheitern und du musst das Backup einspielen.
Ob eine Erweiterung kompatibel ist, siehst du im Shopware Store, bei der Prüfung durch den Updater in der Administration oder im Shopware-Account unter Lizenzen.
- Bereits kompatibel: Die installierte Version läuft mit der neuen Shopware-Version.
- Mit der neuen Shopware Version: Nach dem Update kannst du die Erweiterung auf eine kompatible Version aktualisieren.
- Nicht kompatibel: Es gibt keine Nachfolgeversion, die Erweiterung passt nicht zur neuen Version.
3. Update per Administration
In der Administration findest du den Updater unter Einstellungen > System > Shopware-Update. Dort siehst du deine aktuelle Version. Vor dem Start prüft Shopware die Systemvoraussetzungen und zeigt für jede aktive Erweiterung einen der drei Kompatibilitätsstatus.
Im nächsten Schritt deaktivierst du inkompatible Erweiterungen. Der Updater bietet dafür drei Optionen: Alle Erweiterungen deaktivieren, Inkompatible Erweiterungen deaktivieren, oder das Update ohne Deaktivierung auf eigenes Risiko. Die letzte Option kann laut Doku dazu führen, dass das Update abbricht oder der Shop danach nicht mehr erreichbar ist. In der Regel reicht die empfohlene Einstellung.
Bevor Installieren aktiv wird, bestätigst du mit dem Haken bei Ja, ich habe meine Daten gesichert, dass ein aktuelles Backup vorliegt. Danach läuft das Update durch, links erscheinen grüne Häkchen.
- Einstellungen > System > Shopware-Update öffnen.
- Systemvoraussetzungen und Erweiterungskompatibilität lesen.
- Inkompatible Erweiterungen deaktivieren lassen.
- Backup bestätigen und Installieren klicken.
4. Update mit dem Shopware Installer
Der Shopware Installer ist eine einzelne PHP-Datei, mit der du Shopware sowohl installierst als auch aktualisierst. Liegt die Datei in einem leeren public-Verzeichnis, startet die Installation. In einer bestehenden Shopware-Installation startet sie das Update.
Lädst du die Datei per FTP hoch, stelle den Übertragungstyp auf binär (in FileZilla unter Übertragung > Übertragungstyp > Binär). Sonst kann die Datei laut Doku beschädigt werden.
- shopware-installer.phar.php aus dem Download-Bereich des Changelogs laden.
- Datei in den public-Ordner deiner Shopware-Installation legen.
- Im Browser deine-domain.de/shopware-installer.phar.php aufrufen, das Update startet.
- Nach Abschluss die Administration öffnen und den Shop prüfen.
5. Update über Composer
Seit Shopware 6.3.0 geht das Update auch über Composer, und Shopware empfiehlt diesen Weg. Du arbeitest dabei in der Shell im Hauptverzeichnis des Shops.
Neben shopware/core passt du in der composer.json auch die Versionen von shopware/administration, shopware/storefront und gegebenenfalls shopware/elasticsearch an die Zielversion an.
- bin/console system:update:prepare ausführen.
- In der composer.json shopware/core und die übrigen Shopware-Pakete auf die Zielversion setzen.
- composer update ausführen.
- Datenbank-Migrationen mit bin/console system:update:finish ausführen.
- Mit composer recipes:update die Konfigurationsdateien aktualisieren.
6. Wenn der Updater Erweiterungen nicht deaktivieren kann
Startet das Update nicht, schlägt die Doku diese Reihenfolge vor: zuerst im Updater Alle Erweiterungen deaktivieren wählen statt nur der inkompatiblen. Klappt das nicht, die Erweiterungen unter Erweiterungen > Meine Erweiterungen von Hand deaktivieren. Als letzter Weg geht die Deaktivierung auch direkt in der Datenbank, dafür verlinkt die Doku eine eigene Anleitung.
Hast du die Erweiterungen selbst deaktiviert, wählst du beim Update keine der Deaktivierungsoptionen mehr. Bei einem Major-Update, etwa von 6.4 auf 6.5, müssen laut Doku alle Erweiterungen deaktiviert werden.
7. Was du beim Update auf Shopware 6.7 beachten solltest
Für Shopware 6.7 nennt der Update-Guide als Voraussetzungen PHP 8.2, 8.3 oder 8.4, Node.js 20 oder höher, MySQL ab 8.0.17 (problematisch sind 8.0.20 und 8.0.21) oder MariaDB ab 10.11 (problematisch sind 10.11.5 und 11.0.3), Redis ab 7.0 optional.
Technisch wechselt 6.7 von Webpack zu Vite, nutzt Vue 3 ohne Kompatibilitätsmodus und Pinia statt Vuex. Plugins mit Komponenten in der Administration brauchen deshalb getrennte Versionen für 6.6 und 6.7. Frag bei individuellen Plugins also vorher beim Entwickler oder deiner Agentur nach einer 6.7-Version.
8. Nach dem Update: Suche und Filter testen
Nach jedem Update lohnt ein kurzer Rundgang durch den Shop: Startseite, Kategorie mit Filtern, Warenkorb, Checkout und die Suche. Tippe dabei auch einen Begriff mit Tippfehler ein und prüfe, ob die Ergebnisse noch stimmen. Die Einstellungen der Standardsuche findest du unter Einstellungen > Allgemein > Suche.
Grumeria läuft getrennt von deiner Shopware-Installation: Die Suche liest deine Produkte über den Produktfeed aus dem Produktvergleich, das kostenlose Plugin Grumeria Suche bindet das Such-Widget ein. Die Tarife beginnen bei 29 € netto im Monat, die ersten 14 Tage sind kostenlos.
Häufige Fragen
Wie mache ich ein Shopware-6-Update?
Über Einstellungen > System > Shopware-Update in der Administration, mit dem Shopware Installer (shopware-installer.phar.php im public-Ordner) oder über Composer. Shopware empfiehlt Composer, weil er stabiler ist und keine Timeouts verursacht. Vorher immer ein Backup erstellen.
Macht Shopware vor dem Update ein Backup?
Nein. Laut Shopware-Doku erstellt Shopware selbst keine Backups. Du richtest sie auf dem Server ein oder lässt sie vom Hoster erstellen.
Was passiert mit inkompatiblen Erweiterungen?
Sie müssen vor dem Update weg. Der Updater kann inkompatible oder alle Erweiterungen deaktivieren. Laut Doku dürfen unter Meine Erweiterungen keine inkompatiblen Erweiterungen auftauchen, auch keine inaktiven.
Welche PHP-Version braucht Shopware 6.7?
Laut Update-Guide PHP 8.2, 8.3 oder 8.4, dazu Node.js 20 oder höher und MySQL ab 8.0.17 oder MariaDB ab 10.11.
Was mache ich, wenn das Update nicht startet?
Im Updater Alle Erweiterungen deaktivieren wählen, sonst die Erweiterungen unter Erweiterungen > Meine Erweiterungen von Hand deaktivieren. Danach beim Update keine Deaktivierungsoption mehr wählen.