Shopware aktualisieren / updaten

Starte ein Update nur, wenn Du über entsprechende Erfahrung verfügst oder kontaktiere Deine Partneragentur, damit sie Dich unterstützt oder Shopware aktualisiert.

Testumgebung anlegen

Damit Du ein Shopware Update vorab in Deiner Umgebung testen kannst, empfehlen wir Dir eine Testumgebung anzulegen. Wie genau Du diese anlegst, erfährst Du hier.

Update absichern

Wenn Du keine Testumgebung angelegt hast, erstelle in jedem Fall ein Backup, nur so kannst Du bei Problemen einfach wieder den Betrieb aufnehmen! Außerdem empfehlen wir in jedem Fall, dass immer vor einem Update des Live-Systems ein Backup erstellt werden muss, auch wenn dies vorher im Testsystem geprüft wurde.

Beachte, dass Shopware selber keine Backups erstellt. Diese solltest Du auf Deinem Server separat einrichten. Wenn Du Deinen Server bei einem Hostingpartner gehostet hast, übernimmt dieser in der Regel das Erstellen der Backups. Im Zweifel setze Dich mit Deinem Hostingpartner in Verbindung.

Bitte beachte, dass sich die Systemvoraussetzungen geändert haben, die Systemvoraussetzungen für 6.5.0.0 findest Du hier.

Erweiterungs Kompatiblität - WICHTIG

Stelle vor dem Update sicher, dass alle Deine installierten Erweiterungen aktuell und kompatibel sind und lösche ggf. inkompatible Erweiterungen, bevor Du updatest, da es sonst beim Update zu Problemen kommen kann und Du ein Backup einspielen musst. Es dürfen keine inkompatiblen Erweiterungen unter Meine Erweiterungen auftauchen! Egal ob aktiv oder nicht.
Ob Deine Erweiterungen kompatibel sind, siehst Du in unserem Store, über die Überprüfung durch den Auto-Updater im Admin oder über den Shopware-Account unter Lizenzen prüfen.

Update per Browser

Shopware Installer

Mit dem Shopware Installer kannst Du in wenigen Schritten sowohl Shopware installieren als auch updaten. Für beides wird die gleiche PHP-Datei verwendet. Dadurch wird eine automatisierte Installation bzw. automatisiertes Update durchgeführt.
Wird die Datei in einem leeren public Verzeichnis gespeichert und aufgerufen, wird der Installations-Prozess gestartet.
Bei einer bereits bestehenden Shopware-Installation wird der Update-Prozess gestartet.

Schritt 1: Lade Dir die PHP-Datei aus dem Download-Bereich herunter (1).
Schritt 2: Im Anschluss verschiebst Du die Datei in den public Ordner Deiner Shopware Installation.

In einigen FTP-Tools wie z.B. Filezilla kann es vor dem Upload der Datei notwendig sein, den richtigen Übertragungstyp zu wählen, da die Datei sonst beschädigt werden kann. Im Beispiel von Filezilla wählen Sie Übertragung -> Übertragungstyp -> Binär

Schritt 3: Rufe dann die Datei im Webbrowser auf:

www.meine-url.de/shopware-installer.phar.php

Das Update wird nun gestartet.

Das Update ist durchgeführt und Du kannst die Administration aufrufen.

Update per Administration

Selbstverständlich kannst Du ein Update auch direkt über die Administration durchführen. Du findest die Option unter Einstellungen > System > Shopware-Update. In dem Fenster bekommst Du Deine aktuelle Version angezeigt.

Schritt 1: Systemvoraussetzungen überprüfen

(1) Bevor Du das Update startest, werden die Systemvoraussetzungen nochmal überprüft. Sollte dort etwas nicht im grünen Bereich sein, solltest Du Dein System unbedingt vorher auf die erforderlichen Systemvoraussetzungen überprüfen und gegebenenfalls anpassen.

(2) Beim Punkt Erweiterungskompatibilität erfährst Du noch, ob Deine aktivierten Erweiterungen in der nächsten Version zur Verfügung stehen. Eine der drei folgenden Statusmeldungen wird bei Dir im System hinter jeder Erweiterung beim Update stehen:

Bereits kompatibel - Bedeutet, dass die installierte Version der Erweiterung mit der neuen Shopware Version bereits kompatibel ist.
Mit der neuen Shopware Version - Bedeutet, dass Du nach dem Update des Shops die Möglichkeit hast, die Erweiterung auf eine kompatible Version zu aktualisieren.
Nicht kompatibel - Bedeutet, dass es für diese Erweiterung keine Nachfolgeversion gibt und diese inkompatibel mit der neuen Shopware Version sein wird.

Schritt 2: Erweiterungen deaktivieren

Der letzte Schritt vor der Installation des Updates erfordert die Überprüfung Deiner Erweiterungen. Hier solltest Du alle inkompatiblen Erweiterungen deaktivieren (3). Im Anschluss kannst Du das Update installieren.

Die Bestätigung, dass Du eine Sicherung erstellt hast, ist immer notwendig. Setze den Haken bei Ja, ich habe meine Daten gesichert, wenn Du auf ein aktuelles Backup zurrückgreifen kannst. Im Anschluss wird Installieren aktiv und Du kannst das Update starten.
Das obere Formular wird Dir angezeigt, wenn Shopware bei der Überprüfung inkompatible oder nicht überprüfbare Erweiterungen in Deiner Installation feststellt.

Alle Erweiterungen deaktivieren versuche alle aktiven Erweiterungen zu deaktivieren, unabhängig davon ob sie kompatibel sind oder nicht.
Inkompatible Erweiterungen deaktivieren führt dazu, dass der Shopware Updater vor dem eigentlichen Update alle Erweiterungen deaktiviert, die Dir vorher als nicht kompatibel angezeigt worden sind.
Ich bin mir der potentiellen Gefahren bewusst... hiermit bestätigst Du, dass Du ein Update durchführen möchtest, ohne das Shopware eine Erweiterung deaktiviert. Wenn Du diese Option wählst, birgt das die Gefahr, dass das Update abbricht oder der Shop bei erfolgreichem Update nicht mehr aufgerufen werden kann.

In der Regel reicht es aus, dass Du das Update mit der empfohlenen Einstellung startest.

Welche Möglichkeiten habe ich, wenn der automatische Updater nicht alle Erweiterungen deaktivieren kann?

Wenn das Update nicht startet, kann das unterschiedliche Gründe haben. Daher stellen die folgenden Punkte mögliche Lösungen dar, die bereits bei mehrmals erfolgreich angewendet wurden.

Da per Standard nur die inkompatiblen Erweiterungen deaktiviert werden, wähle Alle Erweiterungen deaktivieren und starte dann das Update erneut.
Wenn Du auch hier die Meldung erhältst, dass der automatische Updater die Erweiterungen nicht deaktivieren konnte, versuche unter Erweiterungen > Meine Erweiterungen die Erweiterungen manuell zu deaktivieren.
Die Deaktivierung der Erweiterungen ist auch per Datenbank möglich. Dazu findest Du eine ausführliche Anleitung hier.
Beim Majorupdate, zum Beispiel von 6.4 auf 6.5 ist es notwendig alle Erweiterungen zu deaktivieren. Auch dafür kannst Du die Anleitung unter 3. verwenden. Bei dem SQL Befehl zur Deaktivierung der Erweiterungen lässt Du dann den WHERE Teil weg.

Hast Du einen der Punkte 2.-4. angewendet, wähle beim Update keine der Optionen zur Deaktivierung der Erweiterungen durch den Updater.

Schritt 3: Installiere das Update

Wenn Du alle Schritte befolgt hast und das Update installierst, wirst Du auf der linken Seite die grünen Häkchen sehen. Dann kannst Du das Update erfolgreich abschließen.

Update über Composer

Seit Version 6.3.0 ist dieser Weg möglich. Navigiere mit der Shell in das Hauptverzeichnis des Shops. Dort gibst Du diesen Befehl ein:

bin/console system:update:prepare

Öffne dann die composer.json im Hauptverzeichnis und ersetze shopware/core... mit der benötigten Shopware Version.
Daraufhin kannst Du mit folgendem Befehl das Update durchführen:

composer update

Die Versionen von shopware/administration, -storefront, elasticsearch usw. müssen ebenfalls für die gewünschte Shopware Version angepasst werden.

Führe die Datenbank Migration mit folgendem Befehl aus:

bin/console system:update:finish

Um die Aktualisierung aller Konfigurationsdateien zu erzwingen, führe diesen Befehl aus:

composer recipes:update

Bekannte Fehler umgehen

APP_ENV=dev web_profiler fehlende Erweiterung Fehler: Vor Shopware Version 6.4.17.0 musst Du das Profiler-Bundle installieren, damit APP_ENV=dev funktioniert:

composer require --dev profiler

framework:demo-data fehlen Faker-Klassen: Vor Shopware Version 6.4.17.0 musst Du einige Pakete installieren, damit der Befehl framework:demo-data funktioniert:

composer require --dev mbezhanov/faker-provider-collection maltyxx/images-generator