Skip to main content

​
Overview

The Gitea integration links a Ordo project to a repository on your Gitea instance. Tasks sync with issues, and webhooks keep Ordo updated when issues, pull requests, or pushes change. You need:
  • Gitea base URL: e.g. https://git.example.com.
  • Personal access token with permission to read/write issues and repository contents for the target repo.
  • Repository owner and name: same as in the Gitea UI.

​
Personal access token

  1. In Gitea, open Settings → Applications → Generate New Token (paths may vary slightly by version).
  2. Enable scopes for repository and issues (write access where needed).
  3. Copy the token and store it securely; paste it into Ordo’s Gitea integration settings.

​
Webhook in Gitea

Ordo verifies incoming webhooks with a HMAC SHA256 secret stored per integration.

​
Where to create the webhook in Gitea

  1. Log in to Gitea and open the same repository you linked in Ordo (owner/repo).
  2. Open the repository Settings.
  3. In the left sidebar, open Webhooks (sometimes grouped under a “Repository” section).
    • If you do not see it, you need admin access to that repository (owner or collaborator with admin).
  4. Click Add Webhook and choose Gitea.
Direct URL pattern (replace host, owner, and repo): https://<your-gitea-host>/<owner>/<repo>/settings/hooks Example: https://git.example.com/acme/my-app/settings/hooks

​
Configure the webhook

  1. Connect the repository in Ordo Project → Integrations → Gitea and save.
  2. Copy the Webhook URL and Secret shown in Ordo (after saving).
  3. In Gitea: Add Webhook → Gitea.
  4. Set Payload URL to the Ordo webhook URL.
  5. Set Secret to the exact value from Ordo.
  6. Enable Content type: application/json.
  7. Enable events:
    • Push
    • Pull requests
    • Issues (open, close, label, edit, etc.)
    • Issue comments
    • Create (used for label creation events on some Gitea versions)
  8. Save and use Test Delivery to confirm a 200 response from Ordo.
The webhook URL includes your integration id, for example: https://your-Ordo-host/api/gitea-integration/webhook/<integrationId>