kaneo (minimalist kanban) fork to experiment adding a tangled integration
github.com/usekaneo/kaneo
docs: add Gitea integration setup guide
+65
+60
apps/docs/core/integrations/gitea/setup.mdx
+60
apps/docs/core/integrations/gitea/setup.mdx
···
1
+
---
2
+
title: Gitea Setup
3
+
description: Connect Kaneo to a Gitea instance (issues, pull requests, webhooks).
4
+
---
5
+
6
+
## Overview
7
+
8
+
The Gitea integration links a Kaneo project to a repository on your Gitea instance. Tasks sync with issues, and webhooks keep Kaneo updated when issues, pull requests, or pushes change.
9
+
10
+
You need:
11
+
12
+
- **Gitea base URL**: e.g. `https://git.example.com`.
13
+
- **Personal access token** with permission to read/write issues and repository contents for the target repo.
14
+
- **Repository owner and name**: same as in the Gitea UI.
15
+
16
+
## Personal access token
17
+
18
+
1. In Gitea, open **Settings → Applications → Generate New Token** (paths may vary slightly by version).
19
+
2. Enable scopes for **repository** and **issues** (write access where needed).
20
+
3. Copy the token and store it securely; paste it into Kaneo’s Gitea integration settings.
21
+
22
+
## Webhook in Gitea
23
+
24
+
Kaneo verifies incoming webhooks with a **HMAC SHA256** secret stored per integration.
25
+
26
+
### Where to create the webhook in Gitea
27
+
28
+
1. Log in to Gitea and **open the same repository** you linked in Kaneo (`owner/repo`).
29
+
2. Open the repository **Settings**.
30
+
3. In the **left sidebar**, open **Webhooks** (sometimes grouped under a “Repository” section).
31
+
- If you do not see it, you need **admin** access to that repository (owner or collaborator with admin).
32
+
4. Click **Add Webhook** and choose **Gitea**.
33
+
34
+
**Direct URL pattern** (replace host, owner, and repo):
35
+
36
+
`https://<your-gitea-host>/<owner>/<repo>/settings/hooks`
37
+
38
+
Example: `https://git.example.com/acme/my-app/settings/hooks`
39
+
40
+
### Configure the webhook
41
+
42
+
1. Connect the repository in Kaneo **Project → Integrations → Gitea** and save.
43
+
2. Copy the **Webhook URL** and **Secret** shown in Kaneo (after saving).
44
+
3. In Gitea: **Add Webhook → Gitea**.
45
+
4. Set **Payload URL** to the Kaneo webhook URL.
46
+
5. Set **Secret** to the exact value from Kaneo.
47
+
6. Enable **Content type**: `application/json`.
48
+
7. Enable events:
49
+
50
+
- **Push**
51
+
- **Pull requests**
52
+
- **Issues** (open, close, label, edit, etc.)
53
+
- **Issue comments**
54
+
- **Create** (used for label creation events on some Gitea versions)
55
+
56
+
8. Save and use **Test Delivery** to confirm a `200` response from Kaneo.
57
+
58
+
The webhook URL includes your integration id, for example:
59
+
60
+
`https://your-kaneo-host/api/gitea-integration/webhook/<integrationId>`
+4
apps/docs/docs.json
+4
apps/docs/docs.json
+1
apps/docs/index.mdx
+1
apps/docs/index.mdx
···
11
11
- [Quick Start](/core/index) for the fastest path to a running instance
12
12
- [Installation Guide](/core/installation/index) to choose drim vs Docker Compose
13
13
- [GitHub Integration Setup](/core/integrations/github/setup) for repo sync
14
+
- [Gitea Integration Setup](/core/integrations/gitea/setup) for self-hosted Gitea
14
15
- [Outgoing webhooks](/core/integrations/outgoing-webhooks) for Slack, Discord, and custom HTTP notifications
15
16
- [API Introduction](/api-reference/introduction) for authenticated API usage
16
17