Emailsorter/docs/deployment/SSH-WEBHOOK-FIX-PROMPT.md

Anleitung für SSH – nur EmailSorter (emailsorter.webklar.com) fixen

Kopiere den folgenden Abschnitt und schick ihn an die Person am Server (oder nutze ihn als eigene Checkliste):

---

Kontext

• Nur diese Website: emailsorter.webklar.com (EmailSorter / Gitea-Webhook).
• Nicht anfassen: Alle anderen Websites/Projekte auf dem gleichen Server.
• Problem: Beim Gitea-Webhook („Test Push Event“) kommt 502 Bad Gateway von nginx. Das Backend (Node/PM2) für emailsorter.webklar.com soll geprüft und ggf. neu gestartet werden.

Was ich brauche

1. PM2 prüfen (nur für EmailSorter):

   • pm2 list ausführen.
   • Den Prozess finden, der zu emailsorter.webklar.com / EmailSorter gehört (Name oder Script-Pfad wie server/index.mjs oder emailsorter).
   • Prüfen: Läuft er (Status „online“)? Wenn „stopped“ oder „errored“: das ist wahrscheinlich die Ursache für den 502.

2. Backend für EmailSorter neu starten:

   • Nur den PM2-Prozess für EmailSorter neu starten (nicht pm2 restart all, wenn andere Sites davon betroffen wären).
   • Beispiel, wenn der Prozess „emailsorter“ heißt: pm2 restart emailsorter
   • Oder nur den einen Eintrag in der Liste per Name/ID neu starten.

3. Env für EmailSorter prüfen (optional, nur wenn Webhook weiter 502/401 gibt):

   • In das Projektverzeichnis von EmailSorter wechseln (z. B. /var/www/emailsorter oder wo auch immer es liegt).
   • Prüfen, ob in server/.env (oder im Root-.env) steht:
     GITEA_WEBHOOK_SECRET=<dein Webhook-Secret>
   • Wenn nicht: diese Zeile in der richtigen .env ergänzen (Secret bekommst du separat / steht in Gitea unter Webhook → Secret). Danach nur den EmailSorter-PM2-Prozess neu starten.

4. Kurz testen:

   • curl -s -o /dev/null -w "%{http_code}" https://emailsorter.webklar.com/api/health
     Sollte 200 ausgeben.
   • curl -s -o /dev/null -w "%{http_code}" https://emailsorter.webklar.com/api/webhook/status
     Sollte ebenfalls 200 ausgeben.

5. Nichts anderes ändern: Keine anderen Projekte, keine globalen nginx-/System-Konfigurationen anpassen – nur EmailSorter (emailsorter.webklar.com) wie oben beschrieben.

---

Wenn du den Code gerade neu deployed hast (git pull für EmailSorter): Danach bitte nur den PM2-Prozess für EmailSorter neu starten (z. B. pm2 restart <name-oder-id>), damit die neuen Webhook-Fixes aktiv sind.