Switch Between Instances
When you have multiple Oore CI backend instances connected, you can switch between them without losing your session on either.
What you need
- At least two instances added in the web UI
Switch instances
- Click the instance switcher in the navigation bar
- Select the instance you want to switch to
- The UI reloads with the selected instance's data
What happens when you switch
| Aspect | Behavior |
|---|---|
| Authentication | Each instance has its own session. If you're not signed in to the target instance, you'll be redirected to sign in. |
| Data | Projects, builds, pipelines, and settings are loaded from the selected instance. |
| Query cache | The cache is partitioned by instance ID — switching instances loads a separate cache. |
| URL | API requests are routed to the selected instance's backend URL. |
Session persistence
Sessions persist independently per instance. If you:
- Sign in to Instance A
- Switch to Instance B and sign in
- Switch back to Instance A
You'll still be signed in to Instance A — no re-authentication needed (unless the session expired).
No-instance state
If all instances are removed (or on first visit), the UI shows a "Connect an instance" prompt. You must add at least one instance to use the application.