Skip to main content
Section navigation

Deploy the gateway to Coolify

Deploy the systemprompt.io gateway on Coolify, a self-hostable Heroku-style panel, from a docker-compose service.

On this page

Coolify is a self-hostable, Heroku-style platform you run on your own server. This channel provisions the systemprompt-gateway server plus Postgres from the GHCR image as a docker-compose service.

Pick Coolify when you self-host a control panel and want the gateway managed alongside your other apps, with automatic TLS through its Traefik proxy.

Install (docker-compose service)

  1. Open your Coolify dashboard, then Services > New Service > Docker Compose.
  2. Paste the compose from deploy/coolify/service-template.json (the compose field), or use docker-compose.yml from the repo root with build: . swapped for image: ghcr.io/systempromptio/systemprompt-template:latest.
  3. Coolify pre-creates the env vars it finds in the compose; fill them in on the Environment Variables tab:
    • POSTGRES_PASSWORD: strong random. Set it before the first deploy. Postgres initialises its volume with whatever password is present on first boot, and changing it later fails auth until the volume is wiped.
    • ANTHROPIC_API_KEY and/or OPENAI_API_KEY / GEMINI_API_KEY: at least one; the container refuses to boot without a provider key.
  4. Deploy. The gateway reports healthy on /api/v1/health about a minute after first boot (migrations run on start).
  5. Coolify ignores the compose ports: mapping and exposes services through its Traefik proxy. Set a domain on the gateway service (port 8080) to reach it; the dashboard health status works either way.

Verified end-to-end on Coolify 4.1.2 (2026-07-16).

Domain and TLS

Coolify terminates TLS. Point your domain at Coolify, set it on the gateway service, and it provisions Let's Encrypt automatically.

For the complete recipe, see the full Coolify guide in the template repository. For services, environment variables, and proxy settings, see the Coolify documentation.