45559c0e-d9d4-4741-94b7-ca25b55059d3
Forgeon Docs

Documentation, guides, and patterns to help you build on Forgeon — from your first deploy to running serious infrastructure.

Runtime configuration

Configure runtime, build system, and start behavior.

Last updated: 2026-03-17

Runtime config drives how your app is built and started.

flowchart LR
  A[Idle] --> B[Starting]
  B --> C[Ready]
  C --> D[Degraded]
  D --> E[Stopped]
  C --> E

What you can change

  • Build system (template / nixpacks / buildpacks)
  • Build command
  • Start command
  • Runtime version
  • Internal port

Where to edit

Project → Settings → Build & Deployment

Troubleshooting

Runtime shows wrong framework

  • Override runtime and build settings

Build uses template instead of buildpacks

  • Set build system explicitly and redeploy