n8n 3.0: wat verandert er en hoe bereid je de upgrade voor?

Wat is n8n 3.0?

Een opruimversie. Nieuwe functies levert n8n doorlopend, ongeveer wekelijks, en die wachten niet op een hoofdversie. In 3.0 zit vooral het werk dat wel moest wachten: oude nodes en instellingen die verdwijnen, en standaarden die strenger worden (bron: Introducing n8n 3.0, gecontroleerd op 3 november 2026).

Wat n8n zelf is en hoe het werkt, lees je in Wat is n8n?

Wat verandert er in n8n 3.0?

Dit zijn de thema's uit de aankondiging:

Kubernetes- en Helm-installaties zijn volgens n8n niet geraakt door de Docker-wijziging. Veel oude nodes worden automatisch omgezet.

Host je n8n zelf, dan raakt vooral de Docker-regel je. Wat het verschil tussen de cloud en een eigen server is, lees je in n8n in de cloud of op je eigen server.

Hoe bereid je een upgrade naar n8n 3.0 voor?

Met het Migration Report. Elke instantie vanaf versie 2.39 heeft dat onder Instellingen, Migration Report. Het toont welke workflows en instellingen door 3.0 geraakt worden, lost veel zelf op en bewaart elke aanpassing als nieuwe workflowversie die je eerst kunt nakijken. Gepubliceerde workflows blijven intussen op v2 draaien (zelfde bron).

Zo pak ik het aan bij mijn eigen workflows, en zo raad ik het ook anderen aan:

1. Update eerst naar de nieuwste 2.xDie heeft de nieuwste versie van het rapport.
2. Open het Migration ReportJe ziet per workflow wat er speelt en wie de eigenaar is.
3. Los op of zet op "won't fix"Workflows die niet gepubliceerd zijn of al lang niet meer draaiden, hoef je niet te redden.
4. Maak een volledige back-upOverstappen naar 3.x kan maar één kant op. Terug naar 2.x kan niet.
5. Test eerst op een testinstantiePas daarna ga je naar productie.

Ik loop daarbij vooral langs de dingen die in bedrijfsprocessen vaak voorkomen: planningen, de Code-node, oude nodes en AI-agents. Een workflow die met een lange berekening bijna aan de oude 5 minuten zit, moet je opnieuw bekijken. Wie nog op een oude Cron-node plant, krijgt de Schedule Trigger.

De beta draai ik zelf eerst op een testinstantie. Klantomgevingen gaan pas over als de stabiele versie er is en het rapport schoon is.

Wat merk je ervan als je AI-agents in n8n gebruikt?

Een agent die op een oudere AI Agent-modus of de oude OpenAI-node draait, komt in het Migration Report terecht. Bij Almetaal werken zes gespecialiseerde agents samen aan de centrale mailbox. Bij zo'n opzet kijk je elke agent na voor je de stap zet, want één agent die anders reageert, merk je in de hele keten. Hoe je zulke agents opbouwt, lees je in AI-agents bouwen met n8n.

Draait n8n op een eigen account van de klant, zoals bij Garagebedrijf van Hoof, dan plan je de upgrade samen: het account en de workflows zijn van de klant. Daar zet een AI-agent in de webshop van de groothandel het juiste oliefilter klaar, en zo'n agent test je na de overstap eerst met een paar kentekens.

Wat doe je met retries en API-limieten in je workflows?

Een upgrade is een goed moment om ook dit na te lopen. Een workflow die goed draait, kan toch stilvallen als een API zegt dat je te veel verzoeken stuurt. Dat is een 429-fout (Too Many Requests). Een rate limit is een plafond voor het aantal verzoeken per periode, en throttling vertraagt of zet verzoeken in een wachtrij. De API-aanbieder bepaalt de limiet, jouw workflow bepaalt hoe hij reageert (bron: n8n-blog over throttling en rate limiting, gecontroleerd op 3 november 2026).

Opnieuw proberen helpt alleen als de timing klopt:

• Gebruik Retry-After. Staat die header in het antwoord, volg die dan in plaats van te raden.
• Bouw exponential backoff in. Laat de wachttijd na elke mislukte poging toenemen, bijvoorbeeld 1, 2, 4, 8 seconden.
• Zet een maximum. Een grens aan wachttijd en aantal pogingen voorkomt dat een workflow eindeloos blijft proberen.
• Voeg jitter toe. Wat willekeur in de wachttijd voorkomt dat meerdere workflows tegelijk opnieuw proberen.

Dat hoort bij wat ik beheer noem: bewaken dat een workflow ook op een slechte dag netjes doorloopt of zich meldt.

Upgrade je zelf of laat je het doen?

Heb je een handvol eenvoudige workflows, dan kom je met het Migration Report en een testinstantie een heel eind. Draaien er kernprocessen op n8n, of host je zelf, dan is het fijn als iemand de workflows nakijkt en de overstap test. Ik bouw en beheer n8n-workflows voor ondernemers in Vlaanderen en Nederland, vanuit Antwerpen: bouwen vanaf €1.500 eenmalig en beheer vanaf €150 per maand, excl. btw. Hoe dat werkt, lees je op de pagina n8n-specialist. Of stuur me een WhatsApp met je vraag, dan kijken we in een gratis videocall naar je workflows.

Veelgestelde vragen

Wanneer komt de stabiele versie van n8n 3.0?

Volgens n8n begin december 2026. De beta is sinds 27 oktober 2026 beschikbaar.

Moet ik nu upgraden naar n8n 3.0?

Nee, niet meteen. Draai eerst het Migration Report in je huidige versie (vanaf 2.39) en test de beta op een aparte instantie. Overstappen naar 3.x kan maar één kant op, dus maak vooraf een volledige back-up.

Wat is het Migration Report in n8n?

Een rapport onder Instellingen dat toont welke workflows en instellingen door 3.0 geraakt worden. Het lost veel zelf op en bewaart elke fix als nieuwe workflowversie die je kunt nakijken, terwijl gepubliceerde workflows op v2 blijven draaien.

Werkt mijn self-hosted n8n nog na de upgrade?

Als je n8n op Docker draait, of via Kubernetes of Helm, wel. Heb je n8n met npm of npx geïnstalleerd, dan moet je eerst overstappen naar Docker, want die installatie wordt in 3.0 niet meer ondersteund.

Jurgen Claassens bouwt AI-automatiseringen voor ondernemers, mkb en kmo. Vijftien jaar operations bij Vattenfall, daarna mede-eigenaar van sales- en marketingbureaus. Meer over Jurgen of bekijk zijn projecten.