Aktuelle Version vom 14. Februar 2026, 17:39 Uhr

Gitea Webhook einrichten: Felder richtig ausfüllen

Diese Seite erklärt Schritt für Schritt, wie man einen **Webhook in Gitea** konfiguriert, um automatisch Änderungen auf einen Server zu übertragen (z. B. via `git pull`).

---

1️⃣ Ziel-URL konfigurieren

- Feld:** „Ziel-URL“

Die Ziel-URL ist der Endpunkt auf deinem Server, der das Push-Event empfängt. Damit das richtige Repository aktualisiert wird, muss der Parameter `?repo=` korrekt gesetzt sein.

Deine individuelle Ziel-URL:

https://web.saya.loseyourip.com/git-auto-pull.php?repo={{Ordner}}

Beispiel (für den Ordner "tower"):

https://web.saya.loseyourip.com/git-auto-pull.php?repo=tower

> Erklärung: Jedes Mal, wenn ein Push im Repository passiert, sendet Gitea eine POST-Anfrage an diese URL. Das PHP-Skript nutzt den Namen im Feld `repo`, um im entsprechenden Verzeichnis auf dem Server ein `git pull` auszuführen.

---

2️⃣ HTTP-Methode & Content-Type

Stelle sicher, dass die folgenden Standardwerte in Gitea ausgewählt sind:

**HTTP-Methode:** `POST`
**Inhaltstyp (Content-Type):** `application/json`

---

3️⃣ Webhook testen

Sobald du die URL und die Einstellungen gespeichert hast, kannst du die Verbindung prüfen:

1. Scrolle in den Webhook-Einstellungen ganz nach unten. 2. Klicke auf die Schaltfläche **"Test-Push auslösen"** (oder "Test Delivery"). 3. Wenn alles korrekt eingerichtet ist, erscheint ein grünes Häkchen (Status 200).

---

✅ Zusammenfassung der Daten

| Feld | Wert | |---|---| | **Ziel-URL** | Siehe dynamische Box oben | | **HTTP-Methode** | POST | | **Inhaltstyp** | application/json | | **Ereignisse** | Das Push-Ereignis (Standard) |

> **Tipp:** Falls der Test fehlschlägt (Status 404 oder 500), prüfe, ob das PHP-Skript auf dem Server unter der angegebenen URL erreichbar ist und die Berechtigungen für den Ordner korrekt gesetzt sind.

@@ Zeile 5: / Zeile 5: @@
 ---
-== 1️⃣ Ziel-URL ==
+== 1️⃣ Ziel-URL konfigurieren ==
 **Feld:** „Ziel-URL“
-- Hier trägst du die URL ein, die der Server bereitstellt, um Push-Events zu empfangen.
+Die Ziel-URL ist der Endpunkt auf deinem Server, der das Push-Event empfängt. Damit das richtige Repository aktualisiert wird, muss der Parameter `?repo=` korrekt gesetzt sein.
-- Beispiel:
-<syntaxhighlight lang="text">
+'''Deine individuelle Ziel-URL:'''
-https://web.saya.loseyourip.com/git-auto-pull.php?repo=
+<pre class="dynamic-code">
-</syntaxhighlight>
+https://web.saya.loseyourip.com/git-auto-pull.php?repo={{Ordner}}
+</pre>
-?repo= muss um den Ordnernamen des Repos ergänzt werden damit das richtige repo geupdatet wird
+'''Beispiel (für den Ordner "tower"):'''
+<pre class="static-code">
+https://web.saya.loseyourip.com/git-auto-pull.php?repo=tower
+</pre>
-Container: watchtower Git-Repository: Watchtower Ordner: tower
+> '''Erklärung:''' Jedes Mal, wenn ein Push im Repository passiert, sendet Gitea eine POST-Anfrage an diese URL. Das PHP-Skript nutzt den Namen im Feld `repo`, um im entsprechenden Verzeichnis auf dem Server ein `git pull` auszuführen.
-<syntaxhighlight lang="text">
+---
-?repo=tower
-</syntaxhighlight>
-<syntaxhighlight lang="text">
+== 2️⃣ HTTP-Methode & Content-Type ==
-https://web.saya.loseyourip.com/git-auto-pull.php?repo=tower
-</syntaxhighlight>
+Stelle sicher, dass die folgenden Standardwerte in Gitea ausgewählt sind:
-> Erklärung: Jedes Mal, wenn ein Push im Repository passiert, sendet Gitea eine POST-Anfrage an diese URL.
+* **HTTP-Methode:** `POST`
+* **Inhaltstyp (Content-Type):** `application/json`
 ---
-== 2️⃣ HTTP-Methode / Content-Type ==
+== 3️⃣ Webhook testen ==
-Testen unter Test push event
+Sobald du die URL und die Einstellungen gespeichert hast, kannst du die Verbindung prüfen:
+. Scrolle in den Webhook-Einstellungen ganz nach unten.
+. Klicke auf die Schaltfläche **"Test-Push auslösen"** (oder "Test Delivery").
+. Wenn alles korrekt eingerichtet ist, erscheint ein grünes Häkchen (Status 200).
 ---
+== ✅ Zusammenfassung der Daten ==
+| Feld | Wert |
+|---|---|
+| **Ziel-URL** | Siehe dynamische Box oben |
+| **HTTP-Methode** | POST |
+| **Inhaltstyp** | application/json |
+| **Ereignisse** | Das Push-Ereignis (Standard) |
+> **Tipp:** Falls der Test fehlschlägt (Status 404 oder 500), prüfe, ob das PHP-Skript auf dem Server unter der angegebenen URL erreichbar ist und die Berechtigungen für den Ordner korrekt gesetzt sind.