Skip to main content
Section navigation

Deploy the gateway on Northflank

One-click stack template deploy of the systemprompt.io gateway on Northflank with a managed Postgres addon.

On this page

Northflank is a hosted platform that provisions services, addons, and volumes from a stack template. This channel deploys the systemprompt-gateway server, a managed Postgres addon, and a persistent volume in one workflow.

Pick Northflank when you want a managed Postgres addon and persistent storage provisioned together with the gateway.

One-click deploy

Deploy on Northflank

  1. Click the button. The systemprompt-io template opens pre-filled in your Northflank account; save it.
  2. Add at least one of ANTHROPIC_API_KEY / OPENAI_API_KEY / GEMINI_API_KEY as an argument override (the gateway refuses to boot without a provider key).
  3. Run the template. The workflow provisions a Postgres addon, deploys the gateway with a public HTTPS endpoint on port 8080, links a secret group that wires DATABASE_URL from the addon's admin connection string and EXTERNAL_URL from the generated domain, and attaches a persistent volume for web assets, storage, and profile state.
  4. First boot runs migrations and the publish pipeline; the deploy goes healthy in about 2 minutes. The gateway may restart once or twice while secrets and the volume land; this is expected.
  5. Verify at https://<generated>.code.run/api/v1/health, then open the domain root for the admin UI.

Notes

  • Plans default to nf-compute-20 (fits the free developer allowance); resize the addon and gateway in your project after deploy if you need more headroom.
  • The volume pins the gateway to a single instance (ReadWriteOnce).
  • To create the template yourself, use Templates > Create template and paste deploy/northflank/template.json, then follow steps 2-5.

For the complete recipe, see the full Northflank guide in the template repository. For templates, addons, and volumes, see the Northflank documentation.