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.

Safe change workflow

  1. Apply setting changes in staging first.
  2. Trigger deploy and verify startup + health check.
  3. Compare metrics/logs against previous healthy deploy.
  4. Mirror changes to production once validated.

Troubleshooting

Build succeeds, runtime fails

  • Check start command
  • Check logs for missing envs

Wrong runtime detected

  • Override runtime version in settings

Related