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.

Git integration

GitHub app setup, repo access, and sync behavior.

Last updated: 2026-03-17

Forgeon connects to GitHub via a GitHub App for secure access.

Install the app

  1. Open Settings → Git in Forgeon
  2. Install the GitHub App
  3. Select repositories

How sync works

  • Forgeon clones using the app token
  • Deploys are tied to a commit SHA
  • Preview deployments can follow branch rules

Recommended branch policy

  • Use main/staging split for controlled promotions.
  • Enable preview deploys for pull requests.
  • Lock production deploy path to reviewed branches/tags.

Troubleshooting

Repo not visible

  • Check GitHub App permissions

Wrong branch deploys

  • Update project settings and redeploy

Webhook events not triggering

  • Re-check GitHub App installation scope and repository selection.

Related