Mit n8n 3.0 ist die nächste Hauptversion des Automatisierungswerkzeugs erschienen. Für alle, die n8n selbst betreiben, ist das mehr als ein gewöhnliches Update: Die Version räumt mit alten Knoten, Einstellungen und Installationswegen auf und verschärft mehrere Sicherheitsvorgaben. Wer einfach das neue Image zieht, riskiert, dass einzelne Workflows still stehen. In diesem Beitrag erfährst du, was sich ändert, welche Workflows betroffen sein können und worauf es beim Umstieg ankommt.
Wichtig vorab: 3.0 ist noch eine Vorabversion
Stand 29. Oktober 2026 sind n8n 3.0.0 (27. Oktober) und 3.0.1 (28. Oktober) auf GitHub als Pre-release gekennzeichnet. Die für den Produktivbetrieb empfohlene stable-Version ist laut Dokumentation weiterhin 2.45.5, der Beta-Kanal steht bei 2.46.1. Die 2.x-Reihe bekommt also weiter Korrekturen. Du musst heute nichts überstürzen – solltest die Zeit aber für die Vorbereitung nutzen, denn genau dafür gibt es in n8n 2.x bereits ein eigenes Werkzeug.
Was n8n 3.0 grundsätzlich ändert
Die Hauptversion ist vor allem ein Aufräum- und Sicherheitsrelease. Die offizielle Übersicht der Breaking Changes gliedert die Änderungen in mehrere Bereiche. Die für kleine und mittlere Installationen wichtigsten Punkte:
Selbst gehostet nur noch mit Docker
n8n 3.0 unterstützt keine Installationen mehr, die per npm oder npx n8n laufen, und veröffentlicht kein startfähiges n8n-Paket mehr auf npm. Wer n8n direkt mit Node.js auf dem Server betreibt, braucht vor dem Update einen Umzug auf eine Docker-basierte Installation. Für Team- oder Produktivinstanzen empfiehlt n8n zudem PostgreSQL statt der mitgelieferten SQLite-Datenbank.
Alte Knoten fallen weg
Eine ganze Reihe älterer Knoten wird entfernt. Workflows, die sie noch nutzen, schlagen nach dem Update fehl. Betroffen sind unter anderem:
- Function und Function Item – Ersatz ist der Code-Knoten
- Cron und Interval – Ersatz ist der Schedule Trigger
- Item Lists – Ersatz sind Split Out, Aggregate, Sort, Limit, Remove Duplicates oder Summarize
- Read Binary File(s), Write Binary File und Read PDF – Ersatz sind „Read/Write Files from Disk“ und „Extract from File“
- HTML Extract, iCalendar und Convert to/from binary data
- mehrere alte KI-Knoten, darunter der alte OpenAI-Knoten, Version 1 des AI-Agent-Knotens mit seinen früheren Agent-Modi sowie LangChain Code, für den es keinen direkten Ersatz gibt
Gerade in Installationen, die seit einigen Jahren laufen, stecken solche Knoten oft in Workflows, an die niemand mehr denkt – etwa ein nächtlicher Export mit Cron-Knoten oder eine alte Function, die Bestelldaten umformt. Zusätzlich entfällt der Ausdruckshelfer $getPairedItem; an seine Stelle tritt das normale Item-Linking, zum Beispiel $('Knotenname').item.
Geändertes Verhalten bestehender Knoten
Manche Knoten bleiben, verhalten sich aber anders. Zwei Beispiele, die im Alltag auffallen können:
- „Always Output Data“ bei Knoten mit mehreren Ausgängen wie If oder Switch erzeugt nur noch dann ein leeres Item, wenn alle Ausgänge leer sind. Bisher lief dadurch jeder leere Zweig an – das konnte gewollt oder ein versteckter Fehler sein.
- Der Gmail Trigger in den Versionen 1 bis 1.3 läuft künftig mit dem Verhalten von Version 1.4: Entwürfe werden standardmäßig übersprungen, und pro Abfrage werden höchstens so viele Mails verarbeitet, wie in „Max Emails per Poll“ eingestellt ist.
Auch der Edit-Image-Knoten wechselt in Version 2 auf eine andere Bildbibliothek. Bilder können danach etwas anders aussehen, etwa bei Textplatzierung oder Weichzeichner. Wer damit Produktbilder oder Belege verarbeitet, sollte die Ergebnisse vergleichen.
Strengere Sicherheitsvorgaben
Mehrere Standardwerte werden sicherer – mit möglichen Nebenwirkungen:
- Nicht verifizierte Community-Nodes sind standardmäßig abgeschaltet. Bereits installierte, nicht verifizierte Pakete werden nach dem Update nicht mehr geladen, solange du sie nicht ausdrücklich wieder zulässt.
- Der Task-Runner-Timeout sinkt von fünf Minuten auf eine Minute. Code-Knoten, die länger rechnen, brechen ab, wenn du den Wert nicht selbst setzt.
- Die Rotation des Verschlüsselungsschlüssels ist standardmäßig aktiv. Vorhandene Zugangsdaten bleiben lesbar; ein Datenbank-Backup vor dem Update ist trotzdem Pflicht.
- Der Slack-API-Zugang braucht das Signing Secret. Workflows mit Slack Trigger erhalten ohne dieses Secret keine Ereignisse mehr.
- Die SSRF-Sperrliste wächst um einige Adressbereiche, und der Compression-Knoten entpackt standardmäßig nur noch Archive bis 256 MiB und 1.000 Einträge.
Konfiguration und Speicherort
Beim ersten Start benennt n8n 3.0 das Verzeichnis ~/.n8n/binaryData in ~/.n8n/storage um. Existieren beide Verzeichnisse, startet n8n nicht. Wer ein Volume direkt auf binaryData eingehängt hat, muss den Pfad anpassen. Außerdem fallen einige Umgebungsvariablen weg, und das Chat-Hub-Modul ist standardmäßig abgeschaltet.
Was neu hinzukommt
Neben dem Aufräumen bringt 3.0 auch Neuerungen. Laut den Release-Notes auf GitHub gehören dazu unter anderem eine Absicherung von Webhook- und MCP-Trigger-Knoten über vertrauenswürdige Quellen, die standardmäßig aktive feingranulare Freigabe von Zugangsdaten, ein Microsoft-Teams-Kanal für Agenten, eine neue Version des Edit-Image-Knotens und neue API-Endpunkte, die Abhängigkeiten zwischen Workflows, Zugangsdaten und Datentabellen zeigen. Der eigentliche Mehrwert für den Alltag liegt aber weniger in neuen Funktionen als in einer schlankeren, sichereren Basis für die kommenden 3.x-Versionen.
Was der Umstieg für dich bedeutet
Der Wechsel auf 3.0 ist ein Projekt, kein Knopfdruck. Wie viel Aufwand er macht, hängt davon ab, wie n8n bei dir installiert ist, wie viele Workflows im Einsatz sind und ob alte Knoten, Community-Nodes oder KI-Agenten genutzt werden. n8n liefert in der 2.x-Reihe zwar einen Migrationsbericht, der betroffene Workflows und Einstellungen auflistet – laut Hersteller deckt er aber nicht alle Änderungen ab.
Wer einfach die neue Version einspielt, riskiert stehende Workflows. Gerade bei Abläufen rund um Bestellungen, Rechnungen oder Kundendaten kann das schnell teuer werden.
Wann solltest du aktualisieren?
Für Produktivsysteme gilt: abwarten, bis n8n 3.x als stabile Version freigegeben ist und die ersten Korrekturversionen erschienen sind. Bis dahin sollte die aktuelle 2.x-Version laufen und gepflegt werden. Die Zeit bis zur Freigabe ist ideal für eine gründliche Bestandsaufnahme.
Wer n8n nur für wenige, einfache Workflows nutzt und bereits mit Docker arbeitet, kommt mit wenig Aufwand aus. Bei gewachsenen Installationen mit vielen Workflows, Community-Nodes oder KI-Agenten solltest du deutlich mehr Zeit einplanen.
Fazit
n8n 3.0 macht die Plattform aufgeräumter und sicherer, verlangt aber Vorbereitung: Docker als Pflicht, entfernte Knoten, geänderte Standardwerte. Wer die Wochen bis zur stabilen Freigabe für eine gründliche Bestandsaufnahme nutzt, macht aus dem Wechsel eine planbare Sache statt einer Überraschung.
So unterstützen wir dich
Du nutzt n8n für Abläufe rund um Shop, ERP oder Buchhaltung und willst beim Wechsel auf 3.0 nichts riskieren? Wir begleiten dich vom Check bis zum Update.
- Bestandsaufnahme deiner n8n-Instanz mit Auswertung des Migrationsberichts
- Umzug von einer npm-Installation auf Docker Compose mit PostgreSQL
- Umbau betroffener Workflows, etwa von Function auf Code oder von Cron auf Schedule Trigger
- Testinstanz, Backup-Konzept und Durchführung des Updates im Wartungsfenster
- Hosting und laufende Betreuung deiner n8n-Instanz
Melde dich gern bei uns – wir sehen uns deine Installation an und sagen dir, was der Umstieg für dich bedeutet.
