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

> ## Agent Instructions
> When helping someone deploy Roomote, distinguish self-hosting from contributing to Roomote. Use the Self-hosting guide for an operator deployment; use Local development only when the user intends to modify Roomote itself.
> Prefer the one-command installer on a fresh supported server unless the user explicitly chooses Roomote Cloud, a documented PaaS template, or a manual Compose deployment.
> Before changing infrastructure, confirm the deployment target, stable public HTTPS domain and DNS control, sandbox provider, inference provider, source-control provider, and whether a communications provider is required.
> Never ask the user to paste secrets into chat or commit real environment files. Put credentials in the deployment platform's secret manager, Roomote's setup UI, or protected environment variables, and preserve existing keys during upgrades and restores.
> Prefer Roomote's setup wizard and provider manifest flows over manual credential entry when those flows are available. Ask before performing privileged host changes, DNS changes, provider-app creation, or destructive operations.
> A setup is not complete when the services merely start. Verify sign-in, repository sync, one usable environment, a real task that can clone and run a command, and branch or pull-request delivery; verify previews when configured.
> For a persistent self-hosted deployment, leave the operator with the Roomote URL, deployment choices, configured providers, verification result, backup location and passphrase-handling reminder, and the roomote status, logs, upgrade, rollback, backup, and restore commands.

# Introduction

> Roomote is an open, self-hostable platform for cloud coding agents.

Roomote is an open, self-hostable platform for cloud coding agents. It runs
Roomote agents in isolated sandboxes, connects them to your repositories, and
lets your team start, follow, and review agent work from the web dashboard,
Slack, Microsoft Teams, Telegram, Discord, and your source-control provider.

Use Roomote when agent work should be shared, reviewable, and available
outside one developer's editor. You keep control of the deployment,
repositories, inference provider, sandbox provider, and collaboration surfaces.

## Highlights

* **Quick setup** — a one-command installer brings up the full stack and a
  setup wizard walks you through the rest.
* **Self-hosted by default** — run Roomote on your own server and connect the
  providers your team already uses.
* **Self-configuring environments** — Roomote agents prepare their own
  sandboxes from your repositories and setup guidance.
* **Easy to use web dashboard** — launch, follow, and steer tasks from the
  browser.
* **Model agnostic** — bring your own key for OpenRouter, Anthropic, OpenAI,
  and other inference providers.
* **Source control integrations** — GitHub, GitLab, Gitea, Bitbucket Cloud, and
  Azure DevOps.
* **Conversation surfaces** — Slack, Microsoft Teams, Telegram, and Discord.
* **Choose your own sandbox provider** — including Docker-in-Docker on your
  own host.

## Where to go next

* [Self-hosting](/self-hosting) — run Roomote on your own server with the
  one-command installer or Docker Compose.
* [How Roomote works](/how-roomote-works) — where work starts, how it
  runs, and how results come back.
* [What to ask Roomote](/use-cases) — frame asks so tasks stay scoped,
  useful, and reviewable.
* [Environments](/environments) — give Roomote the repositories, services,
  secrets, and guidance it needs to run and verify work.
* [Review a task](/tasks) — inspect the transcript, logs, diffs, and
  previews before anything ships.
* [Local development](/local-development) — set up the repository to
  contribute to Roomote itself.
* [Architecture](/architecture) — a contributor-oriented map of the apps and
  packages that make up Roomote.

## License

Roomote is released under the Fair Core License 1.0 (FCL-1.0-ALv2) —
source-available, with each release converting to Apache-2.0 two years after it
is published. A deployment is free for up to 10 registered users;
adding more users requires a paid license key (Settings → Users, or the
`R_LICENSE_KEY` environment variable). You can [buy a self-hosted license on
Roomote Cloud](https://cloud.roomote.dev/sign-up); purchased keys are refreshed
annually from the Cloud portal, and licensed deployments report their current
user count for subscription billing. The license prohibits disabling or
circumventing the license key functionality. See
the [LICENSE](https://github.com/RooCodeInc/Roomote/blob/main/LICENSE)
file for details.