Deploy
Use this section for hosted deployment setup.
Use this section for hosted deployment setup.
Start here when you need to run Team OS from a hosted server instead of a local solo workspace.
The deploy guides currently use the
published beta image
ghcr.io/simonc602/team-os-server:beta.
Host Team OS
Deploy Postgres with pgvector and the Team OS API.
Environment variables
Set the required API, auth, public URL, and database variables.
Docker Compose
Run Postgres and the Team OS API in one Compose stack.
Connect after deploy
Sign in from a local workspace after the server is healthy.
Deploy choices
| Path | Use it when |
|---|---|
| Separate Postgres and API services | You need production backups, scaling, and independent lifecycle management. |
| Single Compose or Coolify stack | You need a simpler self-hosted install for a small team. |
Next: Admin