> 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/en/apps/search-intelligent-and-ai-optimized/stage-and-live.md).

# Stage and live

How to keep stage, live and development cleanly apart, connect a copied shop correctly and run several installations under one account.

Every installation needs its own connection to our search system. Otherwise a copy of your shop writes into the search index and statistics of the original. This page shows how to keep stage, live and development apart and how to group several installations under one account.

## Why each installation has its own identity

During installation every shop receives an access key, the Installation Secret. It identifies the installation uniquely. In addition there is the Account Secret, which connects the installation to your account. Both are in the plugin configuration (card "Global configuration").

If you copy a shop including its database, the configuration is copied with it. The copy then carries the same keys as the original and would write into its search index and statistics. You want to avoid that.

## Case 1: New shop or a copy that was not set up yet

Set up the plugin on the stage as usual through the wizard (see [Installation and setup](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/installation-and-setup.md)). If a shop is copied and the setup is run through in the copy, the copy automatically gets its own connection, even if it was already connected.

For stage environments whose feed is not reachable from outside, choose the mode **Push** when creating the feed (see below).

## Several installations under one account

An account groups several installations, for example live, stage and development. This way you manage them centrally under one account. In the wizard you have two ways:

* **"Create new installation":** a new, separate installation is created with shop name, purpose ("Development", "Staging" or "Production") and e-mail.
* **"Connect to existing installation":** you attach the installation to an existing account.

To connect another installation to an existing account:

1. In the new installation, open the wizard (plugin dashboard or plugin configuration, button "Open setup wizard").
2. In the step "Connection type", choose the button "Connect to existing installation".
3. Enter the "Account secret" of the existing account. You find it in the plugin configuration of an already connected installation, card "Global configuration", field "Account secret".
4. Click "Link". The plugin stores and checks the secret.
5. Afterwards, in the step "Connect products", create a feed of its own. Every installation gets its own index.

How the further steps look is described on the page [Installation and setup](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/installation-and-setup.md).

## Case 2: An already connected shop was copied 1:1

If the copy took over the connection of the original, proceed as follows in the copy:

1. Empty both keys on the console:

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

2. Open the wizard in the copy and run through the setup again. Choose "Create new installation" or, to keep the account, "Connect to existing installation".
3. Create a feed of its own and with it an index of its own.

{% hint style="danger" %}
Do not uninstall or deactivate the plugin in the copy beforehand. If original and copy still have the same keys, the original would otherwise be signed off or its data deleted.
{% endhint %}

### If re-registration is rejected

If a shop is already connected to an account, re-registration can be rejected. The admin points this out to you. In that case, contact our support so that re-registration can be released.

### Reset connection

In the plugin configuration there is the button "Reset connection". It deletes both keys locally as well as the setup state. Afterwards you see: "The connection data has been reset. Please set up the connection again." This is an alternative to the console commands.

## Push for stage and development

Stage and DEV systems are often not reachable from outside. Our search system then cannot fetch their feed. Therefore choose the indexing mode **"Push: the plugin sends the products (for DEV/stage)"** in the wizard.

* The plugin sends the products itself, in the background via Shopware.
* Shopware's background processing must run permanently (see [Requirements](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/requirements.md)).
* No product comparison sales channel and no export are created.
* More on progress, cancelling and live sync under [Push and live sync](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/push-and-live-sync.md).

If the stage is reachable from outside without a login, Pull works too.

## When the domain changes

After a move to another domain or after a stage copy, the stored feed address still points to the old domain. The wizard then reports "The feed was not found at this URL". Check the domain of the sales channel or create the feed again. A move to a new server with the same domain and the same database does not change the connection.

## Continue reading

{% content-ref url="/pages/1Lxj7Rpj8iUl7dhClF69" %}
[Installation and setup](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/installation-and-setup.md)
{% endcontent-ref %}

{% content-ref url="/pages/kG1p17yKCiPZb4o3gw2S" %}
[Push and live synchronisation](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/push-and-live-sync.md)
{% endcontent-ref %}

{% content-ref url="/pages/mU4m1YpoKatMe6lLhFMB" %}
[Commands](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/commands.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/en/apps/search-intelligent-and-ai-optimized/stage-and-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.
