Skip to main content
Section navigation

Deploy on CasaOS

Run the systemprompt.io gateway on CasaOS in a home lab, with bundled Postgres from the public GHCR image.

On this page

CasaOS runs the systemprompt.io gateway with bundled Postgres from the public GHCR image, so a home lab or single-board server can host it from the CasaOS dashboard.

Pick CasaOS when you run a home lab and want the gateway managed alongside your other self-hosted apps on the local network.

Quickstart

Once the app merges into the CasaOS App Store, install systemprompt from the store. Until then:

  1. CasaOS dashboard, App Store, Install a customized app, Import, paste the deploy/casaos/docker-compose.yml.
  2. Fill in the environment variables: at least one provider key, and POSTGRES_PASSWORD set once before the first start.
  3. Install. First start runs migrations and the publish pipeline, so allow several minutes, then open the app on port 8080.

Required keys

Set at least one of ANTHROPIC_API_KEY, OPENAI_API_KEY, or GEMINI_API_KEY. The app will not start without a provider key.

Access beyond the LAN

CasaOS serves apps on the local network. If you expose the gateway publicly through a reverse proxy or tunnel, set EXTERNAL_URL to that URL in the app settings and restart, so the API URL and CORS origin match.

More detail

For the full walkthrough, see the complete CasaOS recipe in the template repository. For CasaOS itself (app store, customized apps, networking), see the CasaOS wiki.