Create GitHub App for gitea-mq

Pre-fills the GitHub App registration form with the permissions, events and webhook gitea-mq needs. Docs →

App settings

Same value as GITEA_MQ_EXTERNAL_URL. Webhook will be set to …/webhook/github.
Leave the Webhook secret field on the GitHub form blank — gitea-mq sets the App's webhook URL and secret itself on startup from GITEA_MQ_EXTERNAL_URL and GITEA_MQ_GITHUB_WEBHOOK_SECRET.

Permissions

Checkswrite
Commit statusesread
Contentswrite
Pull requestswrite
Administrationwrite
Metadataread

Subscribed events

pull_request check_run status installation installation_repositories

After creating the app

  1. On the App settings page, note the App ID → set GITEA_MQ_GITHUB_APP_ID (or services.gitea-mq.github.appId on NixOS).
  2. Under Private keys, click Generate a private key. Save the downloaded .pem file and point GITEA_MQ_GITHUB_PRIVATE_KEY_FILE at it.
  3. Install the App on the orgs/repos you want managed. gitea-mq picks up every installation automatically.
# env
GITEA_MQ_GITHUB_APP_ID=…
GITEA_MQ_GITHUB_PRIVATE_KEY_FILE=/path/to/key.pem
GITEA_MQ_GITHUB_WEBHOOK_SECRET=
GITEA_MQ_EXTERNAL_URL=…