# Gitea Act Runner – Einrichtung

Einmalig nötig, damit der Release-Workflow (Tag `v*`) automatisch baut + hochlädt.

## 1. Registrierungs-Token holen
Gitea → Repo **GDPR-Content-Blocker** → **Settings → Actions → Runner** →
Button **„Neuen Runner erstellen"**. Es erscheint ein **Registration Token**
(eine lange Zeichenkette). Kopieren.

(Alternativ instanzweit: Admin-Bereich → Actions → Runners → Create new Runner.)

## 2. Token eintragen
In `docker-compose.yml` bei `GITEA_RUNNER_REGISTRATION_TOKEN` einsetzen.

## 3. Runner starten (auf dem Server, wo Docker läuft)
```bash
cd /pfad/zu/gitea-runner
docker compose up -d
docker compose logs -f         # "runner registered successfully" abwarten
```

Danach in Gitea unter Settings → Actions → Runner taucht „hub-runner" mit
Status **idle/online** auf. Ab jetzt laufen Workflows automatisch.

## 4. Testen
Im Plugin-Repo:
```bash
git tag v1.0.1
git push origin v1.0.1
```
Gitea → Repo → Tab **Actions** zeigt den Lauf. Bei Erfolg ist die ZIP im Backend:
```bash
curl https://hub.lucas-orth.de/api/v1/releases/gdpr-content-blocker -H "X-Admin-Token: TOKEN"
```

## Hinweise
- Der Runner braucht Zugriff auf den Docker-Socket (startet die Job-Container).
- Erstes Image (catthehacker/ubuntu) wird beim ersten Lauf gezogen → dauert kurz.
- Das `data/`-Verzeichnis enthält nach der Registrierung die Runner-Identität
  (`.runner`). Nicht löschen, sonst neu registrieren.
- Token wird nur einmal gebraucht; nach erfolgreicher Registrierung ignoriert.