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

Troubleshooting

Repo not visible

  • Check GitHub App permissions

Wrong branch deploys

  • Update project settings and redeploy