n8n lokal testen: npm vs. Docker vs. Desktop-App

n8n lässt sich lokal auf drei offiziell dokumentierten Wegen starten: über das Ein-Zeilen-Setup, über npm oder über Docker. Eine eigene Desktop-App gibt es nicht mehr.

Welcher Weg passt, hängt vom Ziel ab. Für einen kurzen Blick auf die Oberfläche genügt ein Befehl. Soll aus dem Testaufbau später ein Server werden, ist Docker der bessere Ausgangspunkt.

Welche Wege gibt es, n8n lokal zu starten?

Es gibt drei dokumentierte Wege, und sie unterscheiden sich vor allem in Voraussetzungen und Lebensdauer. Alle drei stellen n8n anschließend unter http://localhost:5678 bereit.

Weg | Voraussetzung | Geeignet für | Einschränkung

Weg: Ein-Zeilen-Setup · Voraussetzung: Docker mit Compose-v2-Plugin · Geeignet für: schneller Start mit Datenbank und KI-Diensten · Einschränkung: nur für Neuinstallationen gedacht

Weg: npm global · Voraussetzung: Node.js 20.19 bis 24.x · Geeignet für: lokales Entwickeln einzelner Workflows · Einschränkung: ab n8n 3.0 als veraltet markiert

Weg: Docker · Voraussetzung: Docker · Geeignet für: Testaufbau, der später zum Server wird · Einschränkung: Grundwissen zu Volumes nötig

Der Unterschied liegt nicht im Funktionsumfang, sondern im Aufwand für Pflege und Umzug. Wer den Aufbau später produktiv nutzen will, spart sich mit Docker einen Wechsel.

Wie starten Sie n8n mit dem Ein-Zeilen-Setup?

Das Ein-Zeilen-Setup lädt ein Skript, das einen fertigen Docker-Compose-Stack anlegt und startet. Voraussetzung ist ein laufendes Docker mit dem Plugin docker compose in Version 2.

1curl -fsSL https://get.n8n.io | sh
Copy

Das Skript legt im aktuellen Verzeichnis einen Ordner n8n an. Darin liegen compose.yml, .env und die Konfiguration der mitgelieferten Suchkomponente. Die Daten landen in einem Docker-Volume.

Stoppen und wieder starten läuft danach über Compose:

1docker compose -f ./n8n/compose.yml down
2docker compose -f ./n8n/compose.yml up -d
Copy

Für ein Update rufen Sie dasselbe Skript mit einem Zusatz auf. Zum vollständigen Entfernen samt Daten dient der Befehl mit -v.

1curl -fsSL https://get.n8n.io | sh -s -- --upgrade
2docker compose -f ./n8n/compose.yml down -v
3rm -rf ./n8n
Copy

Der Schalter -v löscht das Volume und damit alle Workflows und Zugangsdaten. Setzen Sie ihn nur, wenn Sie den Aufbau wirklich verwerfen wollen.

Wie installieren Sie n8n über npm?

Die npm-Installation benötigt Node.js in einer Version zwischen 20.19 und 24.x. Sie können n8n damit einmalig ausprobieren oder fest einrichten.

1node -v
2npx n8n
3npm install n8n -g
4n8n start
Copy

npx n8n startet n8n ohne dauerhafte Installation. Der globale Weg über npm install n8n -g behält Workflows und Zugangsdaten zwischen Sitzungen. Gestartet wird danach mit n8n oder n8n start.

Für Updates und einen Rückschritt auf eine ältere Version gelten diese Befehle:

1npm update -g n8n
2npm install -g n8n@1.81.0
3n8n db:revert
Copy

n8n db:revert ist nur nötig, wenn die neuere Version bereits Datenbankmigrationen ausgeführt hat. Zwei Punkte sollten Sie vorher kennen.

Erstens sind npm-Installationen laut n8n-Dokumentation ab n8n 3.0 als veraltet markiert. Zweitens steht der KI-Assistent bei dieser Installationsart nicht zur Verfügung. Für einen dauerhaften Aufbau ist Docker deshalb die tragfähigere Wahl.

Wie starten Sie n8n mit Docker?

Der Docker-Weg besteht aus zwei Befehlen: ein Volume anlegen, dann den Container starten. Das Volume sorgt dafür, dass Daten den Container überleben.

1docker volume create n8n_data
2
3docker run -it --rm \
4 --name n8n \
5 -p 5678:5678 \
6 -e GENERIC_TIMEZONE="Europe/Berlin" \
7 -e TZ="Europe/Berlin" \
8 -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
9 -e N8N_RUNNERS_ENABLED=true \
10 -v n8n_data:/home/node/.n8n \
11 n8nio/n8n
Copy

--rm entfernt den Container beim Beenden. Die Daten bleiben trotzdem erhalten, weil sie im Volume n8n_data liegen. Ohne diesen Mount wären Workflows und Zugangsdaten nach dem Beenden verloren.

Der Image-Tag entscheidet über die Version. Für einen Testaufbau ist eine feste Version die ruhigere Wahl.

Tag | Bedeutung | Empfehlung

Tag: n8nio/n8n · Bedeutung: aktuelle stabile Version · Empfehlung: für kurze Tests brauchbar

Tag: n8nio/n8n:1.81.0 · Bedeutung: feste Version · Empfehlung: für reproduzierbare Aufbauten

Tag: n8nio/n8n:next · Bedeutung: instabile Entwicklungsversion · Empfehlung: nicht für produktive Server

Wo speichert n8n Ihre lokalen Daten?

n8n legt Workflows, Zugangsdaten und vergangene Ausführungen standardmäßig in einer SQLite-Datei ab. Der Pfad ist bei allen drei Wegen derselbe, nur die Umgebung unterscheidet sich.

Weg | Speicherort | Hinweis

Weg: npm · Speicherort: ~/.n8n/database.sqlite · Hinweis: direkt im Benutzerverzeichnis

Weg: Docker · Speicherort: Volume auf /home/node/.n8n · Hinweis: Volume ist Pflicht

Weg: Ein-Zeilen-Setup · Speicherort: Docker-Volume des Compose-Stacks · Hinweis: vom Skript angelegt

Im selben Ordner liegt der Verschlüsselungsschlüssel für die Zugangsdaten. Geht er verloren, lassen sich gespeicherte Zugangsdaten nicht mehr entschlüsseln.

Für einen dauerhaften Betrieb stellen Sie die Datenbank über DB_TYPE=postgresdb und die Variablen DB_POSTGRESDB_HOST, DB_POSTGRESDB_PORT, DB_POSTGRESDB_DATABASE, DB_POSTGRESDB_USER und DB_POSTGRESDB_PASSWORD auf PostgreSQL um.

Gibt es die n8n Desktop-App noch?

Nein, die Desktop-Anwendung wurde eingestellt und das zugehörige Repository ist archiviert. n8n begründet den Schritt mit der geringen Nutzung im Vergleich zu Cloud und Self-Hosting.

Bestehende Installationen lassen sich auf den npm-Weg übertragen, Workflows und Zugangsdaten bleiben dabei erhalten. Der Quellcode ist weiterhin öffentlich, offiziellen Support gibt es dafür aber nicht mehr.

Welche Variante passt zu welchem Zweck?

Für einen kurzen Blick auf die Oberfläche ist das Ein-Zeilen-Setup der schnellste Weg. Für regelmäßiges Entwickeln einzelner Workflows genügt die globale npm-Installation. Für alles, was länger laufen soll, ist Docker die richtige Grundlage.

Ein Punkt entscheidet häufiger als die Technik: Self-Hosting verlangt laufende Pflege. Server, Container, Ressourcen und Absicherung bleiben Ihre Aufgabe. Klären Sie vor der Entscheidung, wie viel dieses Wissens im Team vorhanden ist.

Bei der Automatisierung mit n8n übernehmen wir genau diese Einordnung. Sie entscheiden danach bewusst zwischen lokalem Testaufbau, eigenem Server und der Cloud-Variante.

Typische Fehler und Ursachen

Fünf Fehlerbilder treten bei lokalen Installationen besonders oft auf. Alle lassen sich mit einem Befehl oder einer Umgebungsvariablen lösen.

Die npm-Installation bricht ab oder n8n startet nicht.

Ursache: Die Node.js-Version liegt außerhalb des unterstützten Bereichs. Lösung: Version mit node -v prüfen und auf eine Version zwischen 20.19 und 24.x wechseln. Quelle: Installation mit npm.

Das Ein-Zeilen-Setup meldet, dass Compose fehlt.

Ursache: Auf dem Rechner liegt nur das alte Binary docker-compose, nicht das Plugin. Lösung: Docker Compose v2 installieren und mit docker compose version prüfen. Quelle: Ein-Zeilen-Setup.

Nach dem Beenden des Containers sind alle Workflows verschwunden.

Ursache: Der Mount -v n8n_data:/home/node/.n8n fehlte, deshalb lagen die Daten im Container. Lösung: Volume anlegen und beim Start mounten. Quelle: Installation mit Docker.

Zeitplan-Nodes lösen zur falschen Uhrzeit aus.

Ursache: GENERIC_TIMEZONE und TZ sind nicht gesetzt, der Container läuft auf UTC. Lösung: beide Variablen auf denselben Wert setzen, etwa Europe/Berlin. Quelle: Installation mit Docker.

Nach dem Rückschritt auf eine ältere Version meldet n8n Datenbankfehler.

Ursache: Die neuere Version hat bereits Migrationen ausgeführt. Lösung: nach der Installation der älteren Version n8n db:revert ausführen. Quelle: Installation mit npm.

Häufige Fragen zu n8n lokal testen

Gibt es die n8n Desktop-App noch?

Nein. n8n hat die Desktop-Anwendung eingestellt, das Repository ist archiviert. Als Ersatz empfiehlt n8n die Installation über npm oder Docker.

Welche Node.js-Version brauche ich für die npm-Installation?

n8n verlangt laut eigener Dokumentation eine Node.js-Version zwischen 20.19 und 24.x. Prüfen lässt sich das mit node -v.

Wo speichert n8n meine Workflows bei einer lokalen Installation?

Standardmäßig in der SQLite-Datei ~/.n8n/database.sqlite. Bei Docker liegt dasselbe Verzeichnis im Volume auf /home/node/.n8n. Dort liegt auch der Verschlüsselungsschlüssel.

Kann ich mit einer lokalen npm- oder Docker-Installation direkt produktiv arbeiten?

Technisch ja. n8n weist aber darauf hin, dass Self-Hosting Wissen zu Servern, Containern, Ressourcen und Absicherung voraussetzt. Für den Dauerbetrieb empfiehlt sich der Wechsel auf PostgreSQL und eine bewusste Entscheidung für oder gegen Self-Hosting.