Skip to content

Gondolier Docs

Gondolier is a hosted, multi-tenant merge queue for Forgejo and Gitea. It manages tenant forge connections, encrypted credentials, and queue execution — reusing the shunt engine’s stage → gate → bisect mechanics.

  • Hosted setup — sign up, connect a forge, enrol your first repository.
  • How the queue works — batch, gate, bisect, bounce; what Gondolier does to a repository, and what it never does.
  • Troubleshooting — organised by the symptom you can see in the dashboard.
  • Billing — plans, what counts, worked overage examples, and what happens if a payment fails.
  • Security and data handling — what your forge token is used for, how it is stored, what we log, and how to export or delete your data.
  • API reference — REST endpoints, error codes, and response shapes.

Two things are worth knowing up front:

  1. Your CI must run on gondolier/** pushes. That is how the gate works; without it, batches are staged and nothing reports.
  2. Enrolling a repository does not change its merge rules. Branch protection is a separate, explicit action you take when you are ready.