Funktion
Gitea oder Forgejo mit dem Zuuna-Board verbinden
Für die eigene Gitea- oder Forgejo-Instanz: Adresse, Repository und ein Token, das nicht gespeichert wird — auch ohne Zugang von außen.
Die Gitea-Integration verbindet ein Repository deiner eigenen Gitea- oder Forgejo-Instanz mit einer Gruppe in Zuuna. Weil beide Projekte für den Selbstbetrieb gedacht sind, gibt es keine zentrale Anmeldung: Du gibst die Adresse deiner Instanz an, dazu Besitzer und Repository und ein Zugriffstoken.
Einrichten
Auf der Code-Seite der Gruppe trägst du Instanz-Adresse, Besitzer und Repository ein und legst ein Zugriffstoken bei. Zuuna versucht damit, den Webhook direkt in Gitea anzulegen. Das Token wird dafür einmal verwendet und danach verworfen — gespeichert wird es nicht.
Interne Instanzen
Läuft deine Instanz nur im Firmennetz, kann Zuuna sie nicht erreichen, und die automatische Einrichtung schlägt fehl. Das ist kein Fehler, sondern der eingeplante Fall: Du bekommst URL und Secret angezeigt und legst den Webhook in Gitea selbst an. Ab da schickt deine Instanz die Ereignisse — der Verkehr läuft von innen nach außen, nicht umgekehrt.
Danach
Commits, Branches und Pull Requests landen auf der Karte, deren ID im Commit oder Branch-Namen steht — dieselbe Mechanik wie bei GitHub und GitLab, nur mit deiner eigenen Instanz dahinter.
Tarif
Git auf dem Board gehört zum Developer-Tarif, zusammen mit Releases, dem Code-Graph, der REST-API und Webhooks.
Häufige Fragen
Funktioniert Forgejo genauso?
Ja. Forgejo ist eine Abspaltung von Gitea und spricht dieselbe API, deshalb läuft die Einrichtung identisch ab.
Muss meine Instanz aus dem Internet erreichbar sein?
Nein. Nur die automatische Einrichtung des Webhooks braucht Erreichbarkeit. Ist sie nicht gegeben, legst du den Webhook mit der angezeigten URL und dem Secret selbst an; die Ereignisse schickt danach deine Instanz.
Was passiert mit dem Token?
Es wird einmal für die Einrichtung benutzt und nicht gespeichert. Wenn du es danach in Gitea zurückziehst, bleibt die Verbindung bestehen — sie hängt am Webhook, nicht am Token.