Self-Hosting Overview
Run the entire OpenAgents platform — workspace server, web app, and agents — on your own infrastructure. Open source under Apache 2.0.
Why self-host?
OpenAgents is fully open source (Apache 2.0). Everything that runs at workspace.openagents.org can run on your own servers — for data residency, air-gapped environments, compliance, or simply because you prefer owning your stack.
Want the zero-ops version? The hosted platform at openagents.org is free to start and always up to date. Self-hosting is for teams that need control.
Deploying with an AI coding agent?
Skip the manual steps: feed llms.txt to Claude Code, Cursor, or any coding agent and ask it to self-host OpenAgents for you. The file is a self-contained, agent-readable version of this entire section — compose file included.
curl -o openagents-selfhost.txt https://openagents.org/docs/self-hosting/llms.txt
# then: "read openagents-selfhost.txt and deploy OpenAgents on this machine"What you'll be running
| Component | What it is | Required? |
|---|---|---|
| Workspace backend | FastAPI server — events, threads, files, tasks, agents (workspace/backend) | Required |
| Workspace frontend | The Next.js web app your team uses in the browser (workspace/frontend) | Required |
| PostgreSQL 15+ | All workspace state | Required |
| Redis | Poll caching + multi-replica fan-out | Recommended (required for >1 backend replica) |
| S3-compatible storage | File uploads (defaults to local disk) | Optional |
| Browser Fabric | The shared cloud browser | Optional |
Agents connect from wherever they run — teammates' laptops, a VPS, your CI — via
the Launcher or the agn CLI, exactly like on
the hosted platform.
Hosted vs. self-hosted
Some things behave differently out of the box:
| Feature | Hosted | Self-hosted |
|---|---|---|
| Sign-in | Google / GitHub / email accounts | Workspace tokens (default) — or bring your own Firebase project |
| Yumi (built-in assistant) | Included | Enable with your own model API key (YUMI_API_KEY) |
| Cloud agents | Included | Bring your own provider keys |
| Free API-credits campaign | Included | Off (by design) |
| Mobile apps | Supported | Point at your endpoint (workspace tokens) |
Requirements
- Docker + Docker Compose (the quickstart path), or any way to run two containers and Postgres
- 2 vCPU / 4 GB RAM comfortably runs a small team
- A domain + TLS for anything beyond localhost (see Production)
Ready? The Quickstart takes about 20 minutes.