workboardworkboard

Gitea Setup

Overview

The Gitea integration links a Workboard project to a repository on your Gitea instance. Tasks sync with issues, and webhooks keep Workboard 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 Workboard’s Gitea integration settings.

Webhook in Gitea

Workboard 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 Workboard (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 Workboard Project → Integrations → Gitea and save.

  2. Copy the Webhook URL and Secret shown in Workboard (after saving).

  3. In Gitea: Add Webhook → Gitea.

  4. Set Payload URL to the Workboard webhook URL.

  5. Set Secret to the exact value from Workboard.

  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 Workboard.

The webhook URL includes your integration id, for example:

https://your-kaneo-host/api/gitea-integration/webhook/<integrationId>