n8n 3.0 im Oktober: Diese Breaking Changes treffen dich

Q: Wann genau kommt n8n 3.0?

n8n nennt Oktober 2026 als Zeitraum. Die Doku wird bis dahin laufend ergänzt – ein exaktes Datum steht noch nicht fest.

Gelb-schwarz gestreiftes Warnmuster – Sinnbild für die Breaking Changes in n8n 3.0

n8n 3.0 ist für Oktober 2026 angekündigt, und es ist kein gewöhnliches Update: Über 25 Nodes verschwinden ersatzlos aus dem Baukasten, selbst gehostete Installationen brauchen zwingend Docker, und mehrere Standardeinstellungen kippen ins Gegenteil (n8n Docs). Die gute Nachricht vorweg: Du musst deine Workflows nicht einzeln durchklicken. n8n baut dir dafür einen Bericht ein – und den solltest du diese Woche einmal öffnen.

Das Wichtigste auf einen Blick

Zuerst: In n8n 2.x unter Settings → Migration Report nachsehen – der listet deine betroffenen Workflows und Nodes auf

Self-hosted: npm/npx n8n wird nicht mehr unterstützt – ab 3.0 nur noch Docker

Über 25 Nodes fallen weg, darunter Cron, Interval, Function, Item Lists, HTML Extract und Read PDF

Stille Fallen: Gmail Trigger verhält sich anders, Task-Runner-Timeout sinkt von 5 Minuten auf 1, „Always Output Data” reagiert neu

n8n Cloud: Um Docker und Env-Variablen musst du dich nicht kümmern – die Node- und Verhaltensänderungen treffen dich trotzdem

Der AI-Transform-Node wird automatisch in einen Code-Node umgewandelt – hier musst du nichts tun

Fang hier an: der Migration Report

Der mit Abstand nützlichste Teil der ganzen Umstellung geht in der Doku fast unter. n8n blendet in der laufenden 2.x-Version unter Settings → Migration Report eine Liste ein, die dir zeigt, welche deiner Workflows und Nodes von 3.0 betroffen sind – etwa Sub-Workflows mit entfernten Quellen, Workflows mit der gestrichenen „Any workflow”-Freigabe oder Instanzen, die Chat Hub nutzen.

Dazu kommt: Deine bestehende 2.x-Instanz warnt dich schon jetzt beim Start in den Logs, wenn du eine Konfigurationsvariable setzt, die in 3.0 wegfällt. Zwei Blicke – Report und Startlog – ersparen dir das Raten.

Ohne diesen Report heißt Vorbereitung: 40 Workflows einzeln öffnen. Mit ihm: eine Liste abarbeiten.

Bist du überhaupt betroffen?

Deine Installation	Was dich trifft
n8n Cloud	Node- und Verhaltensänderungen ja. Docker-Pflicht und Env-Variablen nein – das macht n8n
Self-hosted per Docker	alles: Nodes, Verhalten, Env-Variablen, Volume-Pfade
Self-hosted per npm / `npx n8n`	zusätzlich: Umzug auf Docker ist Pflicht, sonst kein Upgrade

Wenn du n8n auf einem eigenen Server betreibst, läuft es in aller Regel ohnehin schon in Docker. Betroffen sind vor allem lokale Test-Installationen und ältere Setups, die damals per npm aufgesetzt wurden.

Die Docker-Pflicht

n8n 3.0 unterstützt keine Installation mehr über npm oder npx n8n – und veröffentlicht schlicht kein lauffähiges npm-Paket mehr. Für lokale Installationen nennt n8n Docker Compose als einfachsten Weg; eine Schritt-für-Schritt-Anleitung will n8n noch nachreichen.

Für dich heißt das: Wenn du n8n bisher mit npx n8n gestartet hast, plane den Umzug vor dem Upgrade. Workflows und Zugangsdaten nimmst du dabei mit – wie das sauber läuft, steht in meiner Update-Anleitung für n8n, inklusive Backup und Rollback.

Über 25 Nodes verschwinden

Das ist der Teil, der bestehende Workflows wirklich zum Stehen bringt. n8n räumt alte Nodes weg, für die es längst Nachfolger gibt.

Weg ab 3.0	Das nimmst du stattdessen
Cron, Interval	Schedule Trigger
Function	Code-Node, Modus Run Once for All Items
Function Item	Code-Node, Modus Run Once for Each Item
Item Lists	die neueren Datennodes
HTML Extract	HTML-Node, Operation Extract HTML Content
iCalendar	Convert to File, Operation Convert to ICS
Read PDF, Read/Write Binary File	aktuelle Datei- und Konvertierungs-Nodes
OpenAI (legacy), OpenAI Assistant/Model	der aktuelle OpenAI-Node im AI-Bereich
HTTP Request Tool (legacy)	HTTP-Request-Node am Tool-Eingang des AI Agent
Workflow Trigger, Manual Chat Trigger	aktuelle Trigger
SerpApi, Orbit	kein direkter Ersatz (Orbit gibt es nicht mehr; SerpApi per HTTP Request)
Motorhead, Zep, Zep Vector Store	anderer Memory- bzw. Vector-Store-Node, kein direkter Ersatz
Binary/JSON Input Loader, GitHub Document Loader	Default Data Loader
Pinecone/Supabase/In Memory: Insert & Load	der jeweils integrierte Vector-Store-Node
AI Transform	wird automatisch in einen Code-Node umgewandelt

Quelle: n8n Docs – v3.0 Breaking changes, Stand September 2026.

Zwei Dinge, die hier oft falsch verstanden werden: Der aktuelle OpenAI-Node im AI-Bereich bleibt – nur die alte Variante fliegt. Und der HTTP-Request-Node als Tool bleibt ebenfalls nutzbar; gestrichen wird nur der separate „HTTP Request Tool”-Node.

Beim AI-Transform-Node musst du gar nichts tun: n8n wandelt bestehende Nodes beim Upgrade automatisch in Code-Nodes um und behält das erzeugte JavaScript bei. Neu hinzufügen kannst du ihn danach nicht mehr.

Die stillen Fallen

Gelöschte Nodes fallen auf – dein Workflow bricht sichtbar. Gefährlicher sind die Änderungen, bei denen alles weiterläuft, nur eben anders.

Gmail Trigger (Versionen 1 bis 1.3). Diese Versionen verhalten sich künftig wie Version 1.4. Konkret: Entwürfe werden nicht mehr mitgenommen, solange du den Filter Include Drafts nicht einschaltest. Gesendete Mails, die nicht im Posteingang liegen, und geplante Mails lösen den Workflow nicht mehr aus. Und Max Emails per Poll (Standard 10) gilt jetzt pro Abruf.

Task-Runner-Timeout: von 300 auf 60 Sekunden. Der Standard für N8N_RUNNERS_TASK_TIMEOUT sinkt von fünf Minuten auf eine. Code-Nodes, die länger rechnen, brechen ab. Wenn du längere Läufe brauchst, setz die Variable explizit.

Always Output Data bei Nodes mit mehreren Ausgängen. Bei If und Switch wird künftig nur dann ein leeres Item ergänzt, wenn alle Ausgänge leer sind. Vorher bekam jeder leere Ausgang eins – wodurch Zweige liefen, die nicht laufen sollten. Das ist eine Korrektur, aber sie kann bestehende Logik kippen.

Sub-Workflows. Die Quellen Local File und URL im Execute-Sub-workflow-Node fallen weg, ebenso der Modus Run once for each item (dafür: Loop Over Items davorschalten). Und die Freigabe „Any workflow” verschwindet: Sub-Workflows, die noch auf dieser Einstellung stehen, lehnen danach jeden Aufruf ab – auch aus dem eigenen Projekt. Beides listet dir der Migration Report auf.

AI Agent Version 1. Die alten Agent-Modi (SQL Agent, Conversational, OpenAI Functions, Plan and Execute, ReAct) fallen mit Version 1 des Nodes weg. Wer schon auf Tools Agent steht, merkt nichts. Für SQL-Agent-Fälle nimmst du künftig ein Postgres- oder MySQL-Tool an einem aktuellen AI-Agent-Node.

Konfiguration: Was du in der Compose-Datei ändern musst

Code auf dunklem Bildschirm – Konfigurationsvariablen vor dem n8n-Upgrade prüfen

Das betrifft nur Self-Hosting. Deine 2.x-Instanz schreibt beim Start bereits eine Deprecation-Warnung ins Log, wenn eine dieser Variablen bei dir gesetzt ist.

Änderung	Was zu tun ist
`~/.n8n/binaryData` heißt jetzt `~/.n8n/storage`	Volume-Mount umhängen oder `N8N_STORAGE_PATH` auf den alten Pfad setzen
`N8N_DEFAULT_BINARY_DATA_MODE=default` ungültig	explizit auf `filesystem`, `s3`, `azure` oder `database` setzen
`N8N_UNVERIFIED_PACKAGES_ENABLED` jetzt `false`	auf `true` setzen, wenn du unverifizierte Community-Nodes installierst
`N8N_RUNNERS_TASK_TIMEOUT` jetzt `60` statt `300`	explizit setzen, wenn Code-Nodes länger brauchen
`N8N_DB_PING_TIMEOUT` entfernt	stattdessen `DB_PING_TIMEOUT_MS`
`OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS` entfernt	Variable löschen, Worker-Speicher prüfen
`N8N_PRE_EXECUTE_ERROR_CREATES_EXECUTION` entfernt	Variable löschen
Chat Hub standardmäßig aus	`chat-hub` zu `N8N_ENABLED_MODULES` hinzufügen, falls gebraucht

Achtung beim Storage-Pfad: Wenn nach dem Upgrade beide Verzeichnisse existieren, startet n8n nicht. Dann verschiebst du den Inhalt von binaryData nach storage, löschst das alte Verzeichnis und startest neu.

Dazu zwei Sicherheits-Defaults, die enger werden: Die SSRF-Blockliste umfasst zusätzlich den Shared Address Space (100.64.0.0/10) und IPv6-Übergangsbereiche – wenn deine Workflows Hosts in diesen Bereichen ansprechen, musst du sie freigeben. Und der Compression-Node entpackt künftig nur noch 256 MiB statt 2 GiB und maximal 1.000 statt 5.000 Dateien pro Archiv.

Deine Checkliste bis Oktober

Migration Report öffnen (Settings) und die Liste abspeichern.
Startlog prüfen – welche Deprecation-Warnungen wirft deine Instanz?
Alte Nodes ersetzen, solange beide Varianten verfügbar sind. Cron → Schedule Trigger und Function → Code sind in Minuten erledigt.
npm-Installation auf Docker umziehen, falls zutreffend.
Compose-Datei durchgehen anhand der Tabelle oben.
Gmail-Trigger-Workflows prüfen – brauchst du Entwürfe oder gesendete Mails?
Backup machen und testen, bevor du upgradest – so geht’s.
Nicht am Releasetag upgraden. Lass die ersten Patches durchlaufen.

Wenn dir dabei auffällt, dass du gar nicht sicher weißt, welcher Workflow bei einem Fehler wen benachrichtigt: Genau dafür lohnt sich einmal Fehlerbehandlung und Monitoring sauber aufzusetzen – spätestens nach dem Upgrade willst du es merken, wenn etwas klemmt.

Häufige Fragen zu n8n 3.0

Wann genau kommt n8n 3.0? n8n nennt Oktober 2026 als Zeitraum. Die Doku wird bis dahin laufend ergänzt – ein exaktes Datum steht noch nicht fest.

Brechen meine Workflows automatisch, wenn ich upgrade? Workflows mit entfernten Nodes laufen nicht mehr. Andere laufen weiter, verhalten sich aber teilweise anders – etwa der Gmail Trigger oder Nodes mit „Always Output Data”. Genau deshalb der Blick in den Migration Report vorher.

Ich nutze n8n Cloud. Muss ich etwas tun? Um Docker, Volumes und Env-Variablen kümmert sich n8n. Die Node-Entfernungen und Verhaltensänderungen betreffen deine Workflows trotzdem – die Checkliste oben gilt für dich ab Punkt 1 und 3.

Muss ich sofort upgraden, wenn 3.0 da ist? Nein. Sinnvoller ist: vorbereiten, ein paar Wochen warten, dann mit Backup upgraden. Wer allerdings ewig auf einer alten Version bleibt, sammelt Sprünge an, die später umso unangenehmer werden.

Was passiert mit meinen Community-Nodes? Unverifizierte Community-Pakete sind künftig standardmäßig deaktiviert. Wenn du welche nutzt, setz N8N_UNVERIFIED_PACKAGES_ENABLED=true, sonst fehlen sie nach dem Upgrade.

Verliere ich Daten beim Upgrade? Nicht durch das Upgrade selbst – Chat-Hub-Daten etwa bleiben in der Datenbank, auch wenn das Modul abgeschaltet wird. Ein vollständiges Backup vorher ist trotzdem Pflicht, allein wegen des Rollback-Wegs.

Fazit: Eine Stunde jetzt spart dir einen kaputten Montag

n8n 3.0 ist ein Aufräum-Release: raus mit Nodes, für die es seit Jahren bessere Nachfolger gibt, engere Sicherheits-Defaults, klare Deployment-Linie. Nichts davon ist unvernünftig – aber es trifft jeden, der Workflows von vor zwei Jahren produktiv laufen hat.

Der pragmatische Weg: Migration Report öffnen, die Liste abarbeiten, alte Nodes jetzt ersetzen, solange beide Varianten nebeneinander existieren. Dann ist der Umstieg im Oktober ein Versionswechsel statt einer Rettungsaktion.

Quellen

n8n Docs: v3.0 Breaking changes – abgerufen 2026-09-20
n8n Docs: Update n8n – abgerufen 2026-09-20
n8n Docs: Back up and restore – abgerufen 2026-09-20

Über den Autor

Ich bin Chris Schweigler, Automatisierungs-Experte aus Österreich und baue n8n-Workflows für selbstständige Onlineunternehmer. Du willst wissen, was 3.0 für deine bestehenden Automationen bedeutet – oder brauchst jemanden, der das Upgrade sauber durchzieht? Schreib mir.