Emailsorter/docs/deployment/WEBHOOK_QUICK_START.md

Gitea Webhook - Quick Start Guide

🚀 Schnellstart (5 Minuten)

Schritt 1: Secret generieren

node -e "console.log(require('crypto').randomBytes(16).toString('hex'))"

Kopiere das generierte Secret - du brauchst es gleich!

Schritt 2: Server konfigurieren

Füge zu server/.env hinzu:

GITEA_WEBHOOK_SECRET=dein_generiertes_secret_hier
DEPLOY_SERVER_HOST=91.99.156.85
DEPLOY_SERVER_USER=root
DEPLOY_SERVER_PATH=/var/www/emailsorter
USE_PM2=true

Schritt 3: Gitea Webhook einrichten

1. Gehe zu deinem Repository → Settings → Webhooks
2. Klicke Add Webhook → Gitea
3. Fülle aus:
   • Target URL: https://emailsorter.webklar.com/api/webhook/gitea (Produktion)
   • Secret: dein_generiertes_secret_hier (aus Schritt 1)
   • Authorization Header (optional): Bearer dein_generiertes_secret_hier (gleicher Wert wie Secret)
   • Trigger On: ✅ Push Events
   • Branch Filter: main oder master
4. Klicke Add Webhook

Schritt 4: Testen

git add .
git commit -m "test: Webhook test"
git push

Prüfe die Server-Logs - du solltest sehen:

📥 Gitea Webhook empfangen
🚀 Starte Deployment...
✅ Deployment erfolgreich abgeschlossen

✅ Fertig!

Jetzt wird bei jedem Push automatisch deployed!

📚 Weitere Informationen

Siehe GITEA_WEBHOOK_SETUP.md für:

• Detaillierte Anleitung
• Fehlerbehebung
• Sicherheitsbest Practices
• Server-Upload Konfiguration