Voraussetzungen
- Shopware 6 (Shopware 5 bekommt keine Core-Updates mehr).
- Ein aktuelles StoreDesk-Plugin im Shop und ein SSH-Zugang. Composer muss nicht installiert sein – fehlt er, lädt StoreDesk ihn nur für diesen Lauf.
- Mindestens 2 GB freier Speicher für Composer und das Backup (die Vorabprüfung zeigt den Wert).
- Starten dürfen Inhaber und Admins. In der einfachen Ansicht ist der Bereich ausgeblendet.
Starten
- Im Shop Wartung › Updates öffnen.
- Zielversion wählen. Die Vorabprüfung zeigt PHP, freien Speicher und eine Tabelle mit der Kompatibilität jedes Plugins.
- Optional „Eigene IPs im Wartungsmodus freigeben“, damit du den Shop während des Updates weiter siehst.
- „Core-Update starten“ und „Update starten“ bestätigen. Du kannst die Seite verlassen – das Update läuft weiter.
Was StoreDesk dabei tut
- Vorabprüfung: Serverprofil, PHP, Composer, Netzwerk, Schreibrechte. Bei einem Fehler bricht der Lauf ab, bevor etwas geändert wurde.
- Backup: Datenbank,
composer.json,composer.lockund der Ordnerconfig/nachvar/storedesk-backups/update-…auf deinem Server. - Wartungsmodus an, aktive Plugins und Themes merken.
- Plugins deaktivieren (mehrere Durchläufe wegen Abhängigkeiten), Standard-Theme setzen. Das StoreDesk-Plugin bleibt aktiv.
- Shopware per Composer aktualisieren, Migrationen ausführen.
- Shop-Test: Startseite und eine Kategorie werden aufgerufen, während der Wartungsmodus für Besucher an bleibt. Scheitert der Test an einer geänderten Twig-Version, setzt StoreDesk die alte Twig-Version und testet erneut; bei anderen Fehlern hält der Lauf an.
- Plugins aktualisieren und in richtiger Reihenfolge wieder aktivieren. Plugins, die mit der Zielversion nicht kompatibel sind, bleiben deaktiviert.
- Themes zurücksetzen und kompilieren, Cache leeren, Wartungsmodus aus, Erreichbarkeit prüfen, Bericht per Benachrichtigung.
Shop außerhalb von StoreDesk geändert
- Live-Prüfung: Vor dem ersten Schritt, der etwas ändert – beim Start und nach jedem „Schritt wiederholen“ vor Composer – liest StoreDesk die installierte Shopware-Version direkt aus dem Shop (
composer.lockper SSH, sonst über das Plugin). Wurde der Shop inzwischen anders aktualisiert, hält der Lauf an, ohne etwas zu ändern: „Der Shop wurde inzwischen geändert (jetzt …). Bitte neu abgleichen und das Update neu planen.“ StoreDesk gleicht den Shop dann sofort neu ab. - Nie ein Downgrade: Ist die Zielversion nicht neuer als die installierte, startet das Update nicht. Auch der Composer-Schritt prüft das unmittelbar vorher noch einmal.
- Per Deployment ausgeliefert: Erkennt das Serverprofil ein Deployment (z. B.
deploy.php,.gitlab-ci.yml,.github/workflows,releases/mitcurrent-Link), ist das Core-Update gesperrt: „Dieser Shop wird per Deployment ausgeliefert – Updates bitte im Repository/Deployment machen; StoreDesk überwacht weiter.“ Inhaber und Admins können die Sperre unter Server & KI › Serverprofil mit „Ich weiß, was ich tue“ aufheben; das steht im Protokoll. Ein.git-Ordner allein ist nur ein Hinweis. - Während das Update läuft, ändert StoreDesk in diesem Shop nichts anderes: Plugin-Aktionen, Schnellaktionen, Angleichen und Automatiken warten („Core-Update läuft“).
Eingebaute Schutzregeln
Manche Kombinationen von Shopware und Paketen sind bekanntermaßen fehlerhaft. StoreDesk kennt sie und greift vorher ein:
- Twig bei Shopware 6.7.14: Twig 3.30 bricht dort App- und Service-Skripte (Fehler 500 im Shop). Vor Composer setzt StoreDesk Twig auf 3.28 fest – außer deine
composer.jsonlegt Twig schon selbst fest, dann gilt deine Angabe. Das steht im Protokoll des Laufs. - Umgebungswerte:
SERVICE_REGISTRY_URL=null://ist ab 6.7.14 ungültig. Die Vorabprüfung zeigt „Umgebungswert passt nicht zur neuen Version“ und bietet „Vor dem Update auskommentieren (empfohlen)“ an; StoreDesk setzt dannENABLE_SERVICES=false. - Fehlende Bundles: Fehlt ein benötigter Eintrag in
config/bundles.php, ergänzt StoreDesk ihn – nach einem Backup der Datei. - Das StoreDesk-Plugin bleibt während des ganzen Updates aktiv.
Wenn etwas schiefgeht
- Schritt wiederholen – etwa nachdem du ein Speicherlimit erhöht hast.
- Mit KI analysieren – der KI-Assistent sucht die Ursache auf dem Server.
- Wartungsmodus beenden – wenn der Shop trotz Fehler wieder erreichbar sein soll.
- Rollback – „Update zurückrollen?“ mit „Rollback starten“ bestätigen.
Was der Rollback zurückholt – und was nicht
| Zurückgeholt | Nicht zurückgeholt |
|---|---|
Datenbank aus dem Backup, composer.json/composer.lock, config/; vendor/ wird per Composer passend neu aufgebaut; Plugins und Themes wieder aktiv. |
Plugin-Ordner, die während des Updates aktualisiert wurden (dafür gibt es je Plugin ein ZIP), Mediendateien, custom/, public/, .env-Dateien. |
Gut zu wissen
Achtung: Weil die Datenbank auf den Stand vor dem Update zurückgeht, fehlen danach Bestellungen und andere Daten, die seit dem Backup entstanden sind. Der Rollback ist für den Notfall direkt nach dem Update gedacht. Hast du das Backup abgewählt, gibt es keinen Rollback – dann Wartungsmodus beenden und die Sicherung deines Hosters einspielen. Weil Backups nach 7 Tagen gelöscht werden, ist ein Rollback danach nicht mehr möglich.
Vor einem großen Versionssprung lohnt sich ein Test auf einer Staging-Kopie. Die PHP-Voraussetzungen prüfst du vorab mit PHP-Wechsel prüfen.
Aufräumen
Hilfsdateien in var/storedesk entfernt StoreDesk nach einem erfolgreichen Lauf; nach einem Fehler bleiben sie für Wiederholen und Rollback liegen. Das Backup wird nach 7 Tagen automatisch gelöscht.