n8n

n8n ist der Klebstoff zwischen allen Systemen. Wiederkehrende Fleißarbeit wird zu einem Ablauf, der von allein läuft: Mitglieder begrüßen, Dokumente weiterreichen, Erinnerungen verschicken.

Was ist n8n?

n8n (gesprochen „n-eight-n“) ist ein Werkzeug für Automatisierungen, ähnlich wie Zapier oder Make, aber selbst betrieben. Man baut Workflows aus Bausteinen (Nodes) in einer grafischen Oberfläche zusammen: Ein Auslöser startet den Ablauf, danach folgen Schritte wie „E-Mail senden“, „Datei speichern“ oder „Webseite abfragen“.

Beispiele aus dem Vereinsalltag

• Ein neues Mitglied wird in Admidio angelegt, n8n schickt eine Willkommensmail mit allen wichtigen Infos.
• Rechnungen, die an kasse@ gehen, landen automatisch in Paperless mit dem Schlagwort „Kasse“.
• Jeden Montag eine Übersicht der Termine der Woche an den Vorstand.
• Ein Formular auf der Website für Probetrainings legt einen Eintrag an und benachrichtigt die Übungsleitung.

Der Container

# auf dem Proxmox-Knoten
pct clone 9000 113 --hostname flows --full
pct set 113 --cores 2 --memory 2048 --onboot 1 \
  --net0 name=eth0,bridge=vmbr0,ip=192.168.178.43/24,gw=192.168.178.1
pct resize 113 rootfs 12G
pct start 113
pct exec 113 -- dpkg-reconfigure openssh-server

Installation

n8n ist eine Node.js-Anwendung und läuft direkt im Container. Welche Node-Version nötig ist, steht in der Installationsanleitung von n8n. Ist die Debian-Version zu alt, kommt Node.js aus dem Repository von NodeSource.

sudo apt install -y nodejs npm
node --version                      # mit der Vorgabe von n8n vergleichen

sudo npm install -g n8n
sudo useradd --system --create-home --home-dir /var/lib/n8n --shell /usr/sbin/nologin n8n

Damit n8n automatisch startet, bekommt es einen systemd-Dienst:

# /etc/systemd/system/n8n.service
[Unit]
Description=n8n
After=network-online.target

[Service]
User=n8n
WorkingDirectory=/var/lib/n8n
Environment=N8N_HOST=flows.meinverein.de
Environment=N8N_PROTOCOL=https
Environment=N8N_PORT=5678
Environment=WEBHOOK_URL=https://flows.meinverein.de/
Environment=GENERIC_TIMEZONE=Europe/Berlin
Environment=N8N_USER_FOLDER=/var/lib/n8n
ExecStart=/usr/bin/env n8n start
Restart=on-failure

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now n8n
journalctl -u n8n -f               # Protokoll ansehen

Im Reverse Proxy flows.meinverein.de auf http://192.168.178.43:5678 zeigen lassen. Wichtig sind die Zeilen für Upgrade und Connection aus der Vorlage, sonst funktioniert der Editor nicht. Beim ersten Aufruf legt man das Besitzer-Konto an. Updates: sudo npm install -g n8n@latest && sudo systemctl restart n8n.

Erste Schritte

1. Zugangsdaten (Credentials) anlegen: das SMTP-Postfach des Vereins, ein API-Token von Paperless (in Paperless unter Profil), Datenbankzugänge. n8n speichert sie verschlüsselt.
2. Einen einfachen Workflow bauen: Schedule Trigger (jeden Montag 8 Uhr) → Send Email. So lernt man die Oberfläche kennen.
3. Webhooks nutzen: n8n stellt eine URL bereit, die andere Systeme bei einem Ereignis aufrufen. Deshalb muss WEBHOOK_URL auf die öffentliche Adresse zeigen.