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.

Easy deploy

Deploy templates from the Forgeon Marketplace in one click.

Last updated: 2026-03-17

Easy deploy lets you launch a project from a Marketplace listing in one flow.

What happens in easy deploy

  1. You click Deploy from a listing
  2. Forgeon opens the Review Configuration modal
  3. Required env vars are filled before project creation
  4. The project is created and deployed

Before you click Deploy

  • Confirm the target environment (staging first is recommended).
  • Review required env keys and secret values.
  • Verify listing compatibility with your plan tier.
  • Check whether listing includes paid dependencies or bundles.
  • Free listing → deploy immediately
  • Paid listing → purchase required before deploy

Bundled services

If the listing includes a DB bundle:

  • The Review modal shows a DB card
  • Eligibility is checked (Pro/Enterprise)
  • DB credentials are injected into envs

Post-deploy verification

  1. Open the deployment URL and confirm HTTP 200.
  2. Check app logs for startup/runtime errors.
  3. Validate at least one core user flow.
  4. Confirm observability metrics are receiving samples.
  5. Attach custom domain only after runtime is healthy.

Troubleshooting quick table

| Symptom | Cause | Fix | | --- | --- | --- | | Deploy button disabled | Missing entitlement or plan gate | Complete purchase or upgrade plan | | Runtime starts then fails | Missing envs or incorrect start command | Re-open review and verify config | | Domain shows placeholder | Domain linked before healthy deployment | Re-map domain after successful deploy |

Related