Migration

Shopware 5 → 6 Migration: vollständige 5-Schritte-Anleitung

Komplette Shopware 5 auf 6 Migrationsanleitung. Migration Assistant Einrichtung, Datentransfer, Theme-Konvertierung, Plugin-Kompatibilität und Go-Live-Checkliste von einem zertifizierten Shopware-Entwickler.

Von Huzaifa Mustafa 12 Min. Lesezeit 28. Oktober 2025

Kurze Antwort

Die Migration von Shopware 5 auf Shopware 6 erfordert fünf kritische Schritte:

Auditieren Sie Ihren aktuellen Shop, um Plugins und Integrationen zu inventarisieren
Migrieren Sie Daten mit dem Migration Assistant
Erstellen Sie Ihr Theme neu und portieren Sie benutzerdefinierte Plugins auf die Architektur von Shopware 6
Testen Sie gründlich, einschließlich Checkout und Integrationen
Führen Sie einen geplanten Go-Live mit Monitoring durch

Rechnen Sie mit 4-8 Wochen für kleine Shops, 3-6 Monaten für Enterprise-Installationen.

Shopware 6 stellt einen vollständigen architektonischen Neuaufbau von Shopware 5 dar. Im Gegensatz zu typischen Versions-Upgrades erfordert diese Migration den Umzug auf eine neue Codebasis, einen modernen Tech-Stack (Symfony, Vue.js) und ein anderes Plugin-System. Diese Anleitung führt Sie durch den kompletten Prozess, basierend auf Dutzenden realer Migrationen.

Schritt 1: Auditieren Sie Ihren Shopware 5 Shop

Bevor Sie irgendeinen Code anfassen, dokumentieren Sie alles in Ihrer aktuellen Shopware 5 Installation. Dieses Audit bestimmt Ihre Migrationskomplexität und den Zeitplan.

Was muss auditiert werden?

Benutzerdefinierte Plugins: Listen Sie alle installierten Plugins auf. Prüfen Sie die Shopware 6 Kompatibilität jedes Plugins im Shopware Store oder auf der Website des Anbieters. Markieren Sie kritische Plugins, die neu entwickelt werden müssen.
Theme-Anpassungen: Dokumentieren Sie alle Template-Overrides, benutzerdefiniertes CSS und JavaScript-Modifikationen. Diese müssen in Shopware 6 manuell neu erstellt werden.
Drittanbieter-Integrationen: Inventarisieren Sie ERP, PIM, Zahlungsgateways, Versandanbieter und Analytics-Integrationen. Prüfen Sie, ob Integrationspartner Shopware 6 unterstützen.
Datenmengen: Zählen Sie Produkte, Kategorien, Kunden, Bestellungen und Mediendateien. Große Kataloge (50.000+ Produkte) erfordern spezielle Migrationsstrategien.

Profi-Tipp: Exportieren Sie Ihre Plugin-Liste aus dem Shopware 5 Plugin-Manager und vergleichen Sie sie mit dem Shopware 6 Store. Planen Sie 50-60% Ihrer Migrationszeit für die Entwicklung benutzerdefinierter Plugins ein, wenn Sie stark angepasste Funktionalität haben.

Schritt 2: Migrieren Sie Ihre Daten mit dem Migration Assistant

Shopware stellt ein offizielles Migration Assistant Plugin für Shopware 6 bereit, das sich mit Ihrer Shopware 5 API verbindet und Daten automatisch überträgt.

Wie funktioniert der Migration Assistant?

Das Plugin läuft in Shopware 6 und zieht Daten von Ihrem Shopware 5 Shop über die API. Es migriert Produkte, Kategorien, Kunden, Bestellungen und Medien in konfigurierbaren Batches.

Migrationsablauf

Migration Assistant installieren in Ihrer Shopware 6 Instanz aus dem Shopware Store (kostenlos).
Verbindung konfigurieren zu Shopware 5, indem Sie die Shop-URL und API-Zugangsdaten angeben.
Datenprofil abrufen, um zu sehen, welche Entitäten migriert werden und geschätzte Anzahlen.
Migration durchführen in Phasen: beginnen Sie mit Produkten und Kategorien, dann Kunden, dann historische Bestellungen.
Daten validieren nach jeder Phase durch stichprobenartige Prüfung von Produkten, Kundenkonten und Bestellhistorie.

Wichtige Einschränkungen: Der Migration Assistant migriert NICHT:

• Einkaufswelten (müssen als Einkaufserlebnisse in Shopware 6 neu aufgebaut werden)
• CMS-Seiten und Shop-Seiten (erfordern manuelle Neuerstellung)
• Benutzerdefinierte Felder und Plugin-Daten (benötigen benutzerdefinierte Migrationsskripte)
• Theme und Design (kompletter Neuaufbau erforderlich)

Profi-Tipp: Planen Sie erhebliche Zeit für den Neuaufbau von Einkaufswelten als Einkaufserlebnisse ein. Dies ist oft der zeitaufwendigste Teil der Migration nach der Theme-Entwicklung. Dokumentieren Sie Ihre bestehenden Einkaufswelten-Konfigurationen mit Screenshots, bevor Sie beginnen.

Schritt 3: Erstellen Sie Ihr Theme neu und portieren Sie Plugins

Shopware 6 verwendet einen völlig anderen Frontend-Technologie-Stack (Twig-Templates, Symfony-Framework, Vue.js-Storefront). Eine direkte Theme-Migration ist nicht möglich.

Theme-Migrationsstrategie

Beginnen Sie mit Shopware 6 Storefront: Verwenden Sie das Standard-Shopware 6 Storefront-Theme als Basis.
Erstellen Sie benutzerdefiniertes Styling neu: Portieren Sie Ihre Markenfarben, Schriftarten und Layouts mit der SCSS-Struktur von Shopware 6.
Erstellen Sie Template-Overrides neu: Konvertieren Sie Smarty-Templates (Shopware 5) zu Twig (Shopware 6).

Was ist mit Plugins?

Shopware 5 Plugins sind nicht kompatibel mit Shopware 6. Für jedes Plugin haben Sie drei Optionen:

1. Durch Shopware 6 Äquivalent ersetzen: Prüfen Sie, ob der ursprüngliche Anbieter eine Shopware 6 Version hat oder finden Sie eine Alternative im Shopware Store.
2. Von Grund auf neu erstellen: Portieren Sie die Funktionalität auf das Plugin-System von Shopware 6 (erforderlich für benutzerdefinierte/proprietäre Plugins).
3. Eliminieren: Bewerten Sie, ob die Funktionalität in Ihrem Shopware 6 Shop noch benötigt wird.

Schritt 4: Testen Sie alles gründlich

Vor dem Go-Live testen Sie jede kritische Geschäftsfunktion durchgehend. Das Überspringen dieses Schritts führt zu Umsatzverlusten und Kundenfrust.

Was sollte vor dem Launch getestet werden?

Checkout-Abläufe

• Gast-Checkout
• Registrierter Kunden-Checkout
• Alle Zahlungsmethoden
• Alle Versandmethoden
• Rabattcodes und Aktionen

Integrationen

• Zahlungsgateway-Verbindungen
• ERP/PIM Datensynchronisation
• Versanddienstleister-APIs
• E-Mail-Benachrichtigungen
• Analytics-Tracking

Performance

• Seitenladezeiten (< 2 Sekunden)
• Lasttests mit Produktions-Traffic
• Suchfunktionalität
• Produktfilterung
• Mobile Performance

Browser-Kompatibilität

• Chrome, Firefox, Safari, Edge
• Mobile Browser (iOS, Android)
• Responsive Design Breakpoints
• Touch-Interaktionen
• Formularvalidierung

Schritt 5: Planen und führen Sie den Go-Live durch

Ein gut geplanter Go-Live minimiert Ausfallzeiten und reduziert Risiken. Starten Sie niemals während verkehrsstarker Zeiten (Wochenenden, Feiertage, Kampagnenstarts).

Pre-Launch Checkliste

Finale Datensynchronisation: Führen Sie eine finale Migration aktueller Bestellungen und Kundenaktualisierungen durch, bevor Sie DNS umschalten.
DNS-Umstellung: Aktualisieren Sie die DNS-Einträge Ihrer Domain, um auf den Shopware 6 Server zu zeigen. TTL-Reduzierung hilft bei schnellem Rollback.
Produktionsmodus: Aktivieren Sie den Shopware 6 Produktionsmodus, deaktivieren Sie Debug-Logs, aktivieren Sie Caching.
Monitoring: Richten Sie Fehlerprotokollierung, Performance-Monitoring (New Relic, Datadog) und Uptime-Alerts ein.
Rollback-Plan: Behalten Sie Shopware 5 für 30 Tage als Backup laufend. Dokumentieren Sie exakte Schritte, um DNS bei Bedarf zurückzusetzen.

Technische Go-Live Schritte

Shopware-Lizenz übertragen: In Shopware 6, gehen Sie zu Einstellungen > Shopware-Konto und aktualisieren Sie Ihren Lizenz-Host auf Ihre Produktionsdomain.
Verkaufskanal-Domains aktualisieren: Konfigurieren Sie die Domain-URL für jeden Verkaufskanal einzeln im Adminbereich.
Webserver konfigurieren: Richten Sie Ihren VirtualHost DocumentRoot auf das /public/ Unterverzeichnis in Ihrer Shopware 6 Installation. Dies ist kritisch für Frontend- und Admin-Zugriff.
Shopware 5 Installation verschieben: Verschieben Sie Ihren Shopware 5 Shop in ein Unterverzeichnis (z.B. /shop5/) oder eine alternative Domain, damit er nicht mehr die primäre Domain verwendet.
Migration abschließen: Nach der Überprüfung, dass alle Daten aktuell sind, schließen Sie die Migration über Einstellungen > Erweiterungen > Migration Assistant > Migration abschließen ab. Dies entfernt migrationsspezifische Datenbankeinträge.

Post-Launch Monitoring-Phase: Überwachen Sie aktiv die ersten 48 Stunden auf Fehler, defekte Integrationen oder Performance-Probleme. Halten Sie Ihr Entwicklungsteam bereit, um kritische Probleme sofort zu beheben.

Wichtig: Deinstallieren Sie das Migration Assistant Plugin nicht sofort nach dem Go-Live, wenn Sie von Plattformen wie Magento migriert haben. Das Plugin bewahrt Passwort-Algorithmen, die für die Kundenauthentifizierung benötigt werden. Für Shopware 5 Migrationen können Sie es sicher nach Abschluss des Migrationsprozesses entfernen.

Wichtigste Erkenntnisse

Shopware 5 auf 6 Migration ist ein Replatforming-Projekt, kein Upgrade. Planen Sie entsprechend.
Benutzerdefinierte Plugins und Themes erfordern komplette Neuaufbauten in der Shopware 6 Architektur.
Der Migration Assistant behandelt Standarddaten, aber benutzerdefinierte Datenstrukturen benötigen manuelle Migrationsskripte.
Testen ist nicht verhandelbar. Planen Sie mindestens 2 Wochen für vollständige Qualitätssicherung ein.
Behalten Sie Shopware 5 als Backup für 30 Tage nach dem Launch mit einem dokumentierten Rollback-Plan.

Verfasst von Huzaifa Mustafa