• Shopware Gold Partner & Shopify Partner
Shopware-Lizenzen übertragen: Account, Lizenzhost und Composer-Token sauber umziehen

Shopware-Lizenzen übertragen: Account, Lizenzhost und Composer-Token sauber umziehen

Die drei Stellen, an denen eine Shopware-Lizenz hängt

1. Der Shop im Shopware Account. Unter account.shopware.com ist jeder Shop als Domain angelegt. An dieser Domain hängen der Plan (Rise, Evolve, Beyond) und jede gekaufte oder gemietete Erweiterung aus dem Store. Wem der Account gehört, dem gehören die Lizenzen.

2. Der Lizenzhost in der Administration. Unter Einstellungen > System > Shopware Account steht im Feld Lizenzdomain, für welche Domain aus dem Account diese Installation lizenziert ist. Unter Erweiterungen > Meine Erweiterungen > Shopware Account ist die Administration mit einem Login am Account angemeldet. Beides muss zum Account passen, in dem der Shop liegt.

3. Der Composer-Token. Wird der Shop sauber per Composer und Deployment betrieben, kommen Store-Erweiterungen nicht aus der Administration, sondern aus der Composer-Registry packages.shopware.com. Der Zugriff läuft über einen Token, der im Shopware Account pro Shop erzeugt wird und in der auth.json des Projekts steht. Dieser Token gehört zu dem Account, in dem er erzeugt wurde.

Die meisten Probleme nach einem Agenturwechsel entstehen, weil Stelle 1 umgezogen wird und 2 und 3 noch auf die Agentur zeigen. Der Shop läuft dann weiter, bis das nächste Update oder Deployment ansteht.

Bestandsaufnahme vor dem Wechsel

Bevor irgendetwas übertragen wird, brauchen Sie ein vollständiges Bild. Diese Fragen klären wir bei jeder Übernahme in der ersten Woche:

  • In welchem Account liegt der Shop? Melden Sie sich mit Ihrem eigenen Zugang unter account.shopware.com an und öffnen Sie im Shopbetreiberbereich Shops. Fehlt Ihr Shop dort, liegt er fast immer im Partner-Account der Agentur.

  • Welche Erweiterungen sind installiert, und woher kommen sie? Nicht alles, was in der Administration unter Meine Erweiterungen steht, hat eine Store-Lizenz. Typisch sind drei weitere Fälle: Eigenentwicklungen der Agentur, Plugins von Drittanbietern mit eigener Lizenz außerhalb des Stores und Plugins, die irgendwann als ZIP hochgeladen wurden und seitdem keine Updates mehr bekommen.

  • Welche Lizenzart hat jede Store-Erweiterung? Kauf, Miete oder Abo, mit Laufzeit und nächster Verlängerung.

  • Welcher Plan ist gebucht, und wer ist Vertragspartner bei Shopware? Bei Rise, Evolve und Beyond ist das ein eigener Vertrag. Steht dort die Agentur, muss auch dieser Vertrag umgestellt werden.

  • Wie wird deployt? Per Composer und Pipeline, per Hochladen in der Administration oder per Dateiübertragung auf den Server. Davon hängt ab, ob Stelle 3 überhaupt eine Rolle spielt.

Aus dieser Liste ergibt sich, was übertragen werden muss und was nicht übertragbar ist. Eigenentwicklungen und Drittanbieter-Lizenzen laufen nicht über den Shopware Account. Die klären Sie direkt mit der Agentur bzw. dem Anbieter.

Schritt 1: Den Shop im Account übertragen

Die Übertragung startet immer im Account, in dem der Shop gerade liegt. Liegt er bei der Agentur, macht sie diesen Schritt.

  1. Im abgebenden Account unter Shopbetreiber > Shops die Domain auswählen.

  2. Oben bei der Domain den Assistenten zur Lizenzübertragung öffnen.

  3. Die Daten des Empfängers eintragen: Kundennummer, Firmenname und Ansprechpartner Ihres Shopware Accounts. Halten Sie diese Daten bereit, bevor Sie die Agentur bitten.

  4. Den Umfang wählen: den ganzen Shop samt Domain oder einzelne Lizenzen. Beim Agenturwechsel ist fast immer der ganze Shop richtig. Verknüpfte Lizenzen, etwa Advanced Features, wandern mit der Erweiterung.

  5. Absenden. Der Shopware-Vertrieb prüft den Antrag in den folgenden Werktagen.

Was die Übertragung blockiert: ein negatives Guthaben am Shop. Offene Beträge gleicht der bisherige Inhaber vorher aus. Die Sammelrechnung des laufenden Monats geht an ihn und lässt sich danach nicht mehr umschreiben. Klären Sie also vorher, wer welchen Monat bezahlt.

Schritt 2: Die Administration auf Ihren Account umstellen

Sobald der Shop in Ihrem Account angekommen ist:

  1. In der Administration Einstellungen > System > Shopware Account öffnen und prüfen, ob im Feld Lizenzdomain exakt die Domain steht, die in Ihrem Account eingetragen ist. Ohne https://, ohne Pfad.

  2. Unter Erweiterungen > Meine Erweiterungen > Shopware Account den Login der Agentur abmelden und sich mit Ihrem Account anmelden.

  3. Prüfen, ob unter Meine Erweiterungen alle Lizenzen als lizenziert erscheinen und Updates angezeigt werden.

Der Lizenzhost ist übrigens unabhängig von der APP_URL in der Konfiguration des Servers. Ein Shop kann unter einer anderen URL laufen als der, für die er lizenziert ist. Das ist bei Testsystemen gewollt, bei Live-Shops meistens ein Versehen.

Schritt 3: Den Composer-Token austauschen

Dieser Schritt wird am häufigsten vergessen, weil er nicht in der Administration sichtbar ist.

Im Projekt liegt eine Datei auth.json mit einem Eintrag für packages.shopware.com. Der Token darin wurde im Account der Agentur erzeugt. Solange er gültig ist, funktioniert alles. Löscht die Agentur ihn oder wird er nach der Übertragung ungültig, bricht das nächste composer install mit der Meldung Invalid access token ab, und das Deployment schlägt fehl.

So tauschen Sie ihn aus:

  1. In Ihrem Account den Shop öffnen, eine beliebige Erweiterung anklicken und die Schaltfläche für die Installation über Composer wählen (im englischen Account „Install via Composer“).

  2. Einen neuen Token erzeugen und sicher speichern.

  3. Den Token in der auth.json auf dem Server und in den geheimen Variablen der Deployment-Pipeline ersetzen. Alternativ erzeugt das Kommandozeilenwerkzeug shopware-cli mit dem Befehl account merchant shop configure-composer die auth.json direkt für eine Domain Ihres Accounts.

  4. Ein Test-Deployment auf Staging laufen lassen, bevor live etwas passiert.

Die auth.json gehört nicht ins Git-Repository. Shopware schließt sie standardmäßig über die .gitignore aus. Finden Sie den Token bei einer Übernahme im Repository, ist das ein Hinweis, wie dort sonst mit Zugangsdaten umgegangen wurde.

Häufige Fehlermeldungen nach der Übertragung

Lizenzierungshost unbekannt

Die Lizenzdomain in der Administration passt zu keiner Domain in dem Account, mit dem die Administration angemeldet ist. Lizenzdomain unter Einstellungen > System > Shopware Account korrigieren, dann unter Meine Erweiterungen ab- und wieder anmelden.

Falsche Kombination aus Lizenzierungshost und Shopware Account Login

Die Administration ist noch mit dem Login der Agentur angemeldet, der Shop liegt aber schon in Ihrem Account. Oder umgekehrt. Abmelden, mit dem Account anmelden, in dem der Shop jetzt liegt.

Invalid access token beim Deployment

Der Composer-Token in der auth.json gehört noch zum alten Account oder wurde gelöscht. Neuen Token in Ihrem Account erzeugen, siehe Schritt 3.

Erweiterung erscheint als nicht lizenziert

Die Lizenz wurde nicht mit übertragen, sie lief auf einer anderen Domain, etwa einer Testdomain der Agentur, oder sie war nie eine Store-Lizenz. Im Account prüfen, auf welcher Domain die Lizenz liegt. Lizenzen lassen sich innerhalb eines Accounts mit Lizenz übertragen auf eine andere Domain verschieben.

Plan, GMV und Kosten

Für den Wechsel wichtig ist, wie Shopware abrechnet. Wer mehr als 1 Million Euro Bruttowarenumsatz (GMV) im Jahr über den Shop macht und Shopware Account und Store nutzt, braucht einen der Pläne Rise, Evolve oder Beyond. Auch die Pläne selbst richten sich nach dem GMV. Seit dem 14. April 2026 meldet Shopware ab Version 6.7.8 den GMV automatisch.

Für die Übertragung heißt das: Prüfen Sie, ob Ihr Plan zum tatsächlichen Umsatz passt, und wer ihn bei Shopware gebucht hat. Ein Plan, den die Agentur über ihren Partner-Account gebucht hat, wird zusammen mit dem Shop übertragen. Die Vertragsdetails, also Laufzeit, Konditionen und GMV-Grenze, klären Sie danach direkt mit Shopware.

Aufräumen: Lizenzen kündigen, die niemand braucht

Beim Durchgehen der Liste fallen fast immer Erweiterungen auf, die bezahlt, aber nicht mehr genutzt werden. Wichtig: Ein Plugin in der Administration zu deinstallieren oder das Composer-Paket zu entfernen, beendet kein bezahltes Abo. Gekündigt wird nur im Shopware Account. Sonst zahlen Sie weiter für etwas, das gar nicht mehr installiert ist.

Sonderfälle

Die Shop-Domain ändert sich. Benennen Sie die Domain im Account um, statt einen neuen Shop anzulegen: unter Shops die Domain auswählen, in den Shopinformationen Shopdomain umbenennen und die neue Domain mit dem erzeugten Token bestätigen. Alle Lizenzen gelten danach für die neue Domain. Die Lizenzdomain in der Administration müssen Sie neu eintragen, und die Shopware-Version in den Shopinformationen pflegen Sie dort von Hand nach.

Testsysteme. In den Shopinformationen legen Sie fest, ob eine Domain Live-Shop oder Testshop ist. Markieren Sie Staging-Domains als Testshop. Wie ein Testsystem richtig aufgebaut ist, steht im Artikel Shopware-Staging und Backup.

Shopware 5. Lizenzen von Shopware-5-Plugins lassen sich nicht auf Shopware 6 übertragen, wenn das Plugin für Shopware 6 eine eigene Version ist. Bei einem Wechsel, der mit einer Migration zusammenfällt, rechnen Sie die Plugin-Kosten deshalb neu.

Den Partner wechseln

Einem Händler-Account ist genau ein Integrationspartner zugeordnet, und Shopware verlangt Ihre Bestätigung, bevor ein neuer Partner zugeordnet wird. Liegt der Shop schon in Ihrem Account, ist der Partnerwechsel der einfachste Teil. Löst sich die alte Zuordnung nicht von selbst, hilft das Shopware-Kundenteam unter customer@shopware.com.

Checkliste

  • Eigener Shopware Account mit Firmen-E-Mail, nicht mit einer persönlichen Adresse

  • Liste aller Erweiterungen mit Herkunft (Store, Drittanbieter, Eigenentwicklung, ZIP) und Lizenzart

  • Plan und Vertragspartner bei Shopware geklärt

  • Kein negatives Guthaben, Abrechnung des Übergabemonats vereinbart

  • Shop samt Domain in Ihren Account übertragen und von Shopware bestätigt

  • Lizenzdomain in der Administration geprüft, Administration mit Ihrem Account angemeldet

  • Neuer Composer-Token erzeugt, auth.json und Pipeline-Variablen ersetzt, Test-Deployment erfolgreich

  • Ungenutzte Abos im Account gekündigt

  • Staging-Domains als Testshop markiert

  • Neue Agentur als Partner bestätigt

Wie wir das bei arboro machen

Bei einem Wechsel zu arboro ist die Lizenzfrage das erste Arbeitspaket, bevor jemand den Code anfasst. Wir erstellen die vollständige Erweiterungsliste mit Herkunft und Kosten, stimmen die Übertragung mit Ihnen und der bisherigen Agentur ab, stellen Administration und Composer-Token um und prüfen das mit einem Deployment auf Staging. Ungenutzte Lizenzen zeigen wir Ihnen mit den monatlichen Kosten, damit Sie entscheiden können, was gekündigt wird. Den ganzen Ablauf beschreiben wir auf Shopware-Agentur wechseln.

Für die laufende Betreuung nach dem Wechsel: Shopware & Shopify Support. Steht zusätzlich ein Umstieg von Shopware 5 an: Shopware 5 Migration.

Häufige Fragen

Nein. Die Übertragung ändert nur, in welchem Shopware Account die Lizenzen geführt werden. Produkte, Bestellungen und Plugin-Einstellungen liegen in Ihrer Datenbank und bleiben unberührt. Was nach der Übertragung angepasst werden muss, sind Lizenzhost und Login in der Administration und bei Composer-Installationen der Token in der auth.json.

Fast immer, weil die auth.json noch den Composer-Token aus dem Account der Agentur enthält. Erzeugen Sie in Ihrem Account unter Installation über Composer einen neuen Token und ersetzen Sie ihn auf dem Server und in der Pipeline.

Wenn der Shop in ihrem Partner-Account liegt, ja: Die Übertragung startet im abgebenden Account. Reagiert die Agentur nicht, steht im Artikel Shopware-Agentur gibt Zugänge nicht heraus, wie Sie vorgehen.

Nein. Deinstallieren in der Administration oder Entfernen des Composer-Pakets beendet kein bezahltes Abo. Gekündigt wird ausschließlich im Shopware Account.

Die Community Edition ist kostenlos. Wer mit dem Shop mehr als 1 Million Euro GMV im Jahr macht und Account und Store nutzt, braucht nach den Regeln von Shopware einen der Pläne Rise, Evolve oder Beyond.

Autor

Agenturwechsel

Lizenzen, Lizenzhost, Composer-Token: wir stellen alles um.

Bei einem Wechsel zu arboro ist die Lizenzfrage das erste Arbeitspaket. Wir übernehmen Ihren Shop im laufenden Betrieb, zum Festpreis.