(*• ˕ •˶マ
fargone / docs / github

Deploying from GitHub

Connect a repository and let Fargone build and run it whenever you push.

Connect a repo

  1. Create an app and choose Connect a GitHub repo
  2. Pick a repo from the dropdown (powered by the GitHub App you install)
  3. Pick a branch (default main)
  4. Hit Deploy

Fargone clones the repo and builds it with nixpacks.

GitHub App

Fargone uses a GitHub App. Install it once on your account or org — Fargone then lists every repo across your installations and authenticates with a short-lived installation token, so private repos work with no PATs.

  • Callback URL: {FARGONE_APP_URL}/api/github/app/callback
  • Webhook URL: {FARGONE_APP_URL}/api/github/app/webhook
  • Events: push, installation, installation_repositories

Auto-deploy on push

Enable auto-deploy on the app. When a push lands on the app's branch, Fargone queues a new deployment automatically. Push events are verified with the app's webhook secret (HMAC-SHA256).