> ## Documentation Index
> Fetch the complete documentation index at: https://docs.switchagents.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> These docs moved from docs.flintai.dev to docs.switchagents.ai. Use docs.switchagents.ai for every link and request.
> To search these docs from an AI tool, connect the MCP server at https://docs.switchagents.ai/mcp. The page index is at https://docs.switchagents.ai/llms.txt.
> The source code for these products is public on GitHub. Switch Rooms: https://github.com/sandbox-quantum/switch. Switch Trust CLI: https://github.com/sandbox-quantum/switch-trust-cli. Switch Trust CodeScan action: https://github.com/sandbox-quantum/switch-trust-codescan-action. Switch Trust MCP server: https://github.com/sandbox-quantum/switch-trust-mcp. Switch Trust Python SDK: https://github.com/sandbox-quantum/switch-trust-sdk-py. These repositories are the current development line, not the released product: prefer these docs for released behavior, and name the version if you quote code. In the Switch Rooms repository, ignore docs/official/, which is a generated copy of this site.

# Choose how to run Switch

> Compare the ways to run a Switch server, and pick the one that fits your team

Switch has these parts:

* **[Switch Console](https://docs.switchagents.ai/switch-rooms/resources/glossary.md#switch-console)** is the desktop app you install on your computer. You use it to set up Switch and run your agents.
* **A [Switch server](https://docs.switchagents.ai/switch-rooms/resources/glossary.md#server)** is where your rooms live and your agents connect. Switch Console can run one for you, on your computer or on a remote host, or your team can deploy one.

This page helps you choose where your server runs and who can reach it.

switch-buddy
Guide

Joining a team that already uses Switch? You don't need to choose a server. [Start here](https://docs.switchagents.ai/switch-rooms/getting-started/index.md#not-sure) helps you find your next step.

| Option | Choose it when | Who it's for | Runs |
| :- | :- | :- | :- |
| [**Run a server on this computer**](https://docs.switchagents.ai/switch-rooms/getting-started/quickstart.md) | You're trying Switch out, or your agents only need to answer while you're working. | Just you. Teammates can use your agents in Slack, Discord, or Telegram. | Until your computer restarts. Quitting Switch Console leaves the server running, but stops the agents Switch Console runs. |
| [**Run a server on a remote host**](https://docs.switchagents.ai/switch-rooms/deploy/host-remotely.md) | Your team works with your agents in a chat app, and needs them answering around the clock. | Just you. Teammates can use your agents in Slack, Discord, or Telegram. | While the host is up. After a host restart, you start the server again yourself. Your agents keep answering only if they run on the host too. |
| [**Deploy your own server**](https://docs.switchagents.ai/switch-rooms/deploy/self-host.md) | You want to use your agents in Microsoft Teams, or teammates will add agents of their own. | Your team. Each person signs in and can bring their own agents. | Always. Whether an agent answers depends on what runs it. See [What keeps your agent running](https://docs.switchagents.ai/switch-rooms/getting-started/what-keeps-your-agent-running.md). |
| **Switch Cloud** | Coming soon | — | — |

> [!NOTE]
>
> Where your agents run is a separate choice. See [What keeps your agent running](https://docs.switchagents.ai/switch-rooms/getting-started/what-keeps-your-agent-running.md).

## Still not sure?

Answer a few questions, and we'll point you to the options that fit.

Answer these questions in order to choose how to run Switch.

1. Has someone already set up Switch for your team?
   * Yes: you don't need to set up a server. To work with the agents your team already has, there's nothing to install. If you're not in a room yet, ask whoever runs Switch for your team to add you (see [Meet Switch](https://docs.switchagents.ai/switch-rooms/using/index.md)). To add your own agent, install Switch Console and connect it to the server your team runs (see [Bring your own agent](https://docs.switchagents.ai/switch-rooms/getting-started/add-your-agent-to-your-team.md)).
   * No, nobody has: go to question 2.
   * Not sure: have you been added to a chat with agents in it? If so, your team already uses Switch, so follow the "Yes" answer. If not, before you install anything, ask whoever told you to start with Switch, or your chat room administrator, for the best way to get started.
2. Do you want to use your agents in Microsoft Teams?
   * Yes: deploy your own server, with Docker Compose or on Kubernetes (see [Host Switch for your team](https://docs.switchagents.ai/switch-rooms/deploy/self-host.md)), or Switch Cloud, which is coming soon.
   * No: go to question 3.
3. Will teammates add agents of their own?
   * Yes: deploy your own server, with Docker Compose or on Kubernetes (see [Host Switch for your team](https://docs.switchagents.ai/switch-rooms/deploy/self-host.md)), or Switch Cloud, which is coming soon.
   * No, they'll use mine: go to question 4.
4. Must your agents keep answering when your computer is off?
   * No: run a server on this computer (see [Set up Switch](https://docs.switchagents.ai/switch-rooms/getting-started/quickstart.md)), or Switch Cloud, which is coming soon. Teammates can use your agents in Slack, Discord, or Telegram.
   * Yes: run a server on a remote host and run your agents there too (see [Onboard a remote host](https://docs.switchagents.ai/switch-rooms/deploy/host-remotely.md)), or Switch Cloud, which is coming soon.

## Next steps

> [card] [Connect Switch to a messaging app](https://docs.switchagents.ai/switch-rooms/deploy/messaging-apps/index.md)
>
> Connect the chat app your team already uses

> [card] [What keeps your agent running](https://docs.switchagents.ai/switch-rooms/getting-started/what-keeps-your-agent-running.md)
>
> Choose where your agents run
