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.

Quickstart (GitHub)

Connect a repo, review detection, deploy, and get a live URL in minutes.

Last updated: 2026-03-17

This is the fastest path from GitHub to a live URL.

Deploy review modal

Step‑by‑step

  1. Open Dashboard → New Project → Import from GitHub
  2. Select your repo and branch
  3. Review detected settings (framework, build, port)
  4. Click Deploy
  5. Open your Preview URL

What Forgeon detects

Forgeon analyzes the repo and fills defaults:

  • Framework & runtime
  • Build command
  • Start command
  • Internal port

You can edit these in Project → Settings → Build & Deployment.

Add env vars

If your app needs secrets or DB credentials:

  • Go to Settings → Environments
  • Add variables for the target env (prod / staging / preview)
  • Redeploy

Troubleshooting

Deploy fails with “missing envs”

  • Add env vars for the selected environment before deploying

Preview URL loads, but app errors

  • Check runtime logs and start command

Next