> For the complete documentation index, see [llms.txt](https://docs.codegiganten.de/plugin-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/stage-und-live.md).

# Stage und Live

Wie Sie Stage, Live und Entwicklung sauber trennen, einen kopierten Shop richtig anbinden und mehrere Installationen unter einem Account führen.

Jede Installation braucht ihre eigene Verbindung zu unserem Suchsystem. Sonst schreibt eine Kopie Ihres Shops in den Suchindex und die Statistik des Originals. Diese Seite zeigt, wie Sie Stage, Live und Entwicklung getrennt halten und mehrere Installationen unter einem Account zusammenfassen.

## Warum eigene Identität je Installation

Bei der Installation erhält jeder Shop einen Zugangsschlüssel, das Installation Secret. Er kennzeichnet die Installation eindeutig. Dazu kommt das Account Secret, das die Installation mit Ihrem Account verbindet. Beide liegen in der Plugin-Konfiguration (Karte „Globale Einstellungen“).

Kopieren Sie einen Shop samt Datenbank, kopiert sich die Konfiguration mit. Die Kopie trägt dann dieselben Schlüssel wie das Original und würde in dessen Suchindex und Statistik schreiben. Das wollen Sie vermeiden.

## Fall 1: Neuer Shop oder Kopie, die noch nicht eingerichtet war

Richten Sie das Plugin auf der Stage wie gewohnt über den Wizard ein (siehe [Installation und Einrichtung](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/installation-und-einrichtung.md)). Wird ein Shop kopiert und die Einrichtung in der Kopie durchlaufen, bekommt die Kopie automatisch ihre eigene Verbindung, auch wenn sie schon verbunden war.

Für Stage-Umgebungen, deren Feed von außen nicht erreichbar ist, wählen Sie beim Anlegen des Feeds den Modus **Push** (siehe unten).

## Mehrere Installationen unter einem Account

Ein Account fasst mehrere Installationen zusammen, zum Beispiel Live, Stage und Entwicklung. So verwalten Sie sie zentral unter einem Konto. Im Wizard haben Sie dafür zwei Wege:

* **„Neue Installation anlegen“:** Es entsteht eine neue, eigene Installation mit Shop-Name, Einsatz („Entwicklung“, „Staging“ oder „Produktion“) und E-Mail.
* **„Mit bestehender Installation verbinden“:** Sie hängen die Installation an einen vorhandenen Account.

So verbinden Sie eine weitere Installation mit einem bestehenden Account:

1. Öffnen Sie in der neuen Installation den Wizard (Plugin-Dashboard oder Plugin-Konfiguration, Knopf „Zum Einrichtungsassistenten“).
2. Wählen Sie im Schritt „Verbindungsart“ den Knopf „Mit bestehender Installation verbinden“.
3. Tragen Sie das „Account Secret“ des bestehenden Accounts ein. Sie finden es in der Plugin-Konfiguration einer bereits verbundenen Installation, Karte „Globale Einstellungen“, Feld „Account secret“.
4. Klicken Sie auf „Verknüpfen“. Das Plugin speichert und prüft das Secret.
5. Legen Sie danach im Schritt „Produkte anbinden“ einen eigenen Feed an. Jede Installation bekommt ihren eigenen Index.

Wie die weiteren Schritte aussehen, lesen Sie auf der Seite [Installation und Einrichtung](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/installation-und-einrichtung.md).

## Fall 2: Ein bereits verbundener Shop wurde 1:1 kopiert

Hat die Kopie die Verbindung des Originals übernommen, gehen Sie in der Kopie so vor:

1. Leeren Sie beide Schlüssel auf der Konsole:

```bash
bin/console system:config:set CogiInsightSearch.config.installationSecret ""
bin/console system:config:set CogiInsightSearch.config.accountSecret ""
```

2. Öffnen Sie in der Kopie den Wizard und durchlaufen Sie die Einrichtung neu. Wählen Sie „Neue Installation anlegen“ oder, um den Account zu behalten, „Mit bestehender Installation verbinden“.
3. Legen Sie einen eigenen Feed und damit einen eigenen Index an.

{% hint style="danger" %}
Deinstallieren oder deaktivieren Sie das Plugin in der Kopie vorher nicht. Haben Original und Kopie noch dieselben Schlüssel, wird sonst das Original abgemeldet oder dessen Daten werden gelöscht.
{% endhint %}

### Wenn die Neuregistrierung abgelehnt wird

Ist ein Shop bereits mit einem Account verbunden, kann die Neuregistrierung abgelehnt werden. Der Admin weist Sie darauf hin. Wenden Sie sich in diesem Fall an unseren Support, damit die Neuregistrierung freigegeben wird.

### Verbindung zurücksetzen

In der Plugin-Konfiguration gibt es den Knopf „Verbindung zurücksetzen“. Er löscht beide Schlüssel lokal sowie den Einrichtungsstand. Danach heißt es: „Die Verbindungsdaten wurden zurückgesetzt. Bitte richte den Zugang erneut ein.“ Das ist eine Alternative zu den Konsolenbefehlen.

## Push für Stage und Entwicklung

Stage- und DEV-Systeme sind oft von außen nicht erreichbar. Unser Suchsystem kann ihren Feed dann nicht abholen. Wählen Sie deshalb im Wizard die Indexierungsart **„Push: Das Plugin sendet die Produkte (für DEV/Stage)“**.

* Das Plugin sendet die Produkte selbst, im Hintergrund über Shopware.
* Die Hintergrundverarbeitung von Shopware muss dauerhaft laufen (siehe [Voraussetzungen](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/voraussetzungen.md)).
* Es entsteht kein Produktvergleichs-Verkaufskanal und kein Export.
* Mehr zu Fortschritt, Abbruch und Live-Abgleich lesen Sie unter [Push und Live-Abgleich](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/push-und-live-abgleich.md).

Ist die Stage dagegen von außen ohne Anmeldung erreichbar, funktioniert auch Pull.

## Wenn sich die Domain ändert

Bei einem Umzug auf eine andere Domain oder nach einer Stage-Kopie hängt die gespeicherte Feed-Adresse noch an der alten Domain. Der Wizard meldet dann „Der Feed wurde unter dieser Adresse nicht gefunden“. Prüfen Sie die Domain des Verkaufskanals oder legen Sie den Feed neu an. Ein Umzug auf einen neuen Server mit gleicher Domain und gleicher Datenbank ändert die Verbindung nicht.

## Weiterlesen

{% content-ref url="/pages/G8WHK3FCmQgWEZXwYEFm" %}
[Installation und Einrichtung](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/installation-und-einrichtung.md)
{% endcontent-ref %}

{% content-ref url="/pages/TB60BMQ05uLv6epja2ky" %}
[Push und Live-Abgleich](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/push-und-live-abgleich.md)
{% endcontent-ref %}

{% content-ref url="/pages/CjY24FwIjTqbOmJFUGvX" %}
[Befehle](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/befehle.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/stage-und-live.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
