Deploy
Every supported deployment channel for the systemprompt.io gateway: container registries, Kubernetes, one-click PaaS templates, and self-host panels.
On this page
The systemprompt.io gateway is one Rust binary plus PostgreSQL, so it runs anywhere a container or binary runs. Every channel below has a maintained copy-paste recipe in the template repository and its own documentation page here.
For local development, use Installation (just setup-local). For systemprompt.io Cloud, see Cloud Deployment.
Containers and clusters
| Channel | Best for | Docs |
|---|---|---|
| GitHub Container Registry | Any Docker host; the primary public image | ghcr.io/systempromptio/systemprompt-template |
| Helm chart | Kubernetes | Chart with bundled or external Postgres |
| Binary install | Bare-metal, VMs, one-shot installs | curl | sh installer |
| Homebrew | macOS servers and development | Tap formula |
| Nix flake | NixOS / Nix users | Reproducible builds |
One-click PaaS
| Channel | Best for | Docs |
|---|---|---|
| Railway | Fastest hosted deploy, template with managed Postgres | Deploy button |
| Render | Blueprint deploy with managed Postgres | Deploy button |
| Zeabur | Template marketplace deploy | Deploy button |
| Northflank | Stack template with addons | Deploy button |
| DigitalOcean | Single-droplet 1-Click with bundled Postgres | Marketplace image |
Self-host panels
| Channel | Best for | Docs |
|---|---|---|
| Coolify | Coolify service template | One-click from the service catalog |
| Dokploy | Dokploy compose blueprint | Template deploy |
| CapRover | CapRover one-click app | One-click app definition |
| Portainer | Portainer app template / stack | Stack deploy |
| CasaOS | Home lab | App store entry |
The bridge client
The channels above deploy the gateway (server). Developer workstations connect to it with the systemprompt-bridge client; install docs for macOS, Windows (including Scoop), and Linux/headless live in the template repository under docs/cowork/.
After any deploy
Whatever the channel, first boot follows the same sequence: the entrypoint writes a profile, waits for PostgreSQL, runs migrations, and starts the API on port 8080. Verify with:
systemprompt infra services status
and log in at https://<your-host>/admin/login.