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

Recommended baseline for reliability

Keep build/start commands explicit and reproducible.
Pin runtime version for production stability.
Validate health endpoint responses during deploy.
Re-test after each runtime/build-system change.

Troubleshooting

Runtime shows wrong framework

Override runtime and build settings

Build uses template instead of buildpacks

Set build system explicitly and redeploy