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.

Deployment settings

Build, start, runtime, and environment settings per project.

Last updated: 2026-03-17

Deployment settings control how Forgeon builds and runs your app.

Key settings

  • Build command — how your app is built
  • Start command — how your app starts
  • Runtime — language + version
  • Internal port — the port your app listens on inside the container
  • Build system — Template / Nixpacks / Buildpacks

Where to edit

Go to Project → Settings → Build & Deployment.

Re‑analyze

If you change build system or runtime, click Re‑analyze to refresh detected values. Forgeon will keep your selected build system even before re‑analysis completes.

Troubleshooting

Build succeeds, runtime fails

  • Check start command
  • Check logs for missing envs

Wrong runtime detected

  • Override runtime version in settings