Forgeon Docs

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

Configuration reference

Key configuration fields that affect builds, runtime, and deploys.

Last updated: 2026-03-17

This page documents the core configuration fields Forgeon uses to deploy your app.

Runtime config (high level)

build — build command
start — start command
runtime — language runtime
internal_port — the app port inside the container
build_system — template / nixpacks / buildpacks

Where to edit

Project → Settings → Build & Deployment

Minimal baseline config

Build command reproducible in clean environment.
Start command launches one main process.
App binds to 0.0.0.0:$PORT.
Runtime version pinned when compatibility matters.

Troubleshooting

Config not applied

Re‑analyze or redeploy after changes

Unexpected runtime behavior after edits

Compare current config with last known healthy deployment.