npm-Installation
npm ist eine der Möglichkeiten, um n8n schnell auf deinem lokalen Rechner zu starten. Du musst Node.js installiert haben. n8n benötigt Node.js in einer Version zwischen 20.19 und 24.x (inklusive).
Stable- und Beta-Versionen
n8n veröffentlicht nahezu wöchentlich eine neue Minor-Version. Die stable-Version ist für den produktiven Einsatz geeignet, während beta die neueste veröffentlichte Version darstellt, die möglicherweise noch nicht vollständig stabil ist. Für Rückmeldungen oder Fehlerberichte nutze bitte das Community-Forum.
Aktuelle stable-Version: 2.10.2
Aktuelle beta-Version: 2.11.1
n8n mit npx testen
Du kannst n8n direkt ohne Installation über npx ausprobieren.
Führe folgenden Befehl im Terminal aus:
npx n8n
Dieser Befehl lädt alle erforderlichen Komponenten herunter, um n8n zu starten. Sobald dies abgeschlossen ist, öffne http://localhost:5678 in deinem Browser, um auf n8n zuzugreifen und mit dem Erstellen von Workflows zu beginnen.
Globale Installation von n8n (mit npm)
Installiere n8n global mit npm:
npm install n8n -g
Verwende die @-Syntax, um eine bestimmte Version von n8n zu installieren oder zu aktualisieren. Beispiel:
npm install -g [email protected]
Installation der next-Version:
npm install -g n8n@next
Nach der Installation startest du n8n mit folgendem Befehl:
n8n
# oder
n8n start
Nächste Schritte
Nutze die Schnellstart-Anleitung, um die Funktionen von n8n kennenzulernen.
Aktualisierung
Aktualisiere deine n8n-Instanz auf die neueste (latest) Version:
npm update -g n8n
Installation der next-Version:
npm install -g n8n@next
Verwendung des n8n-Tunnels
Achtung
Nur für lokale Entwicklung und Tests gedacht – nicht für den produktiven Einsatz geeignet.
Entwicklungswerkzeug
Die Tunnel-Funktion ist ein praktisches Hilfsmittel für die lokale Entwicklung. Ihre interne Implementierung kann sich bei Updates von n8n ändern.
Um Webhook-basierte Trigger-Knoten externer Dienste wie GitHub nutzen zu können, muss dein n8n-Server aus dem Internet erreichbar sein. n8n bietet hierfür einen Tunnel-Dienst über cloudflared an, der eingehende Anfragen an deine lokale n8n-Instanz weiterleitet. Für die Nutzung des Tunnels ist Docker erforderlich.
Docker erforderlich
Der Tunnel verwendetcloudflared, das als Docker-Container ausgeführt wird. Selbst wenn du n8n über npm betreibst, musst du Docker auf deinem System installiert haben.
Bei einer npm-basierten Installation verwende den Service-only-Modus: Starte cloudflared als eigenständigen Dienst und führe n8n lokal aus:
# Terminal 1: Starte den cloudflared-Tunnel-Dienst
pnpm --filter n8n-containers services --services cloudflared
# Terminal 2: Starte n8n lokal
pnpm dev
Der services-Befehl startet cloudflared, erhält eine öffentliche Tunnel-URL und legt eine .env-Datei mit den Variablen WEBHOOK_URL und N8N_PROXY_HOPS=1 unter packages/cli/bin/.env ab. n8n liest diese .env-Datei beim Start automatisch ein.
Zum Aufräumen nach der Nutzung:
pnpm --filter n8n-containers services:clean
Für den „Full-Stack“-Modus (bei dem sowohl n8n als auch cloudflared in Containern laufen), siehe die Docker-Tunnel-Konfiguration.
Aktualisierung rückgängig machen
Installiere die ältere Version, auf die du zurückwechseln möchtest.
Falls das Upgrade Datenbank-Migrationen beinhaltet hat:
- Prüfe die Feature-Dokumentation und die Release Notes, ob manuelle Änderungen erforderlich sind.
- Führe auf der aktuellen Version
n8n db:revertaus, um die letzte Datenbank-Migration rückgängig zu machen. Falls mehrere Migrationen rückgängig gemacht werden müssen, wiederhole diesen Schritt entsprechend oft.
Problembehandlung unter Windows
Wenn du unter Windows Probleme beim Ausführen von n8n hast, stelle sicher, dass deine Node.js-Umgebung korrekt eingerichtet ist. Folge dazu der Microsoft-Anleitung zum Installieren von Node.js unter Windows.