Automation

n8n 3.0 Breaking Changes and v2.48.7: Preparing Self-Hosted Workflows for Docker-Only Execution

As n8n ships maintenance release 2.48.7 on November 20, 2026 ahead of the n8n 3.0 stable launch, self-hosted teams face mandatory Docker deployment, removed legacy nodes, stricter 60-second runner timeouts, and tightened SSRF and Slack security defaults. Here is how to audit instances with the Migration Report.

By 0xScorPionSon

10 min read

n8n 3.0 Breaking Changes and v2.48.7: Preparing Self-Hosted Workflows for Docker-Only Execution

n8n 3.0 Architecture showing Docker container orchestration, workflow data nodes, security gate, and disconnected legacy npm modules

Executive Summary

  • Latest Release Cadence (November 20, 2026): While n8n 3.0.0 remains in early access ahead of an expected early December 2026 stable launch, n8n shipped maintenance release n8n@2.48.7 on November 20, 2026 alongside beta n8n@2.49.3 and legacy maintenance release n8n@1.123.100, giving self-hosted operators a narrow window to complete pre-upgrade audits.
  • Docker-Only Self-Hosting: According to the n8n v3.0 Breaking Changes documentation, version 3.0 ends support for npm and npx n8n installations and stops publishing a runnable n8n package to npm, making Docker (or Kubernetes/Helm) mandatory for self-hosted deployments.
  • Hard Removals vs. Silent Behavior Shifts: Version 3.0 deletes dozens of deprecated nodes (including Function, Item Lists, Cron, Interval, and v1 AI Agent modes) that prevent affected workflows from activating, while silently altering multi-output Always Output Data behavior, Gmail Trigger polling, and Chat Trigger WebSocket framing.
  • Stricter Runtime & Security Defaults: Default N8N_RUNNERS_TASK_TIMEOUT drops from 300 seconds to 60 seconds, unverified community packages default to disabled, Compression node limits shrink to 256 MiB and 1,000 entries, Slack triggers require a signing secret, and upgrades from 2.x to 3.0 are strictly one-way without a database backup.

What Changed in n8n 2.48.7 and the 3.0 Architecture

On November 20, 2026, the n8n engineering team published three coordinated releases on GitHub Releases: stable n8n@2.48.7 (commit 86dff76), pre-release beta n8n@2.49.3 (commit df32f5e), and 1.x maintenance build n8n@1.123.100 (commit 6a8407b). In 2.48.7, two targeted reliability fixes landed: core now ends the memory guard hold when a hold-limit stop frees no memory (#44463), and scripting nodes store plain input data in their error output (#44530). In 2.49.3, the HTTP Request node gained improved handling for empty response bodies during pagination (#44443).

These point releases arrive as platform teams prepare for n8n 3.0, whose early access breaking changes were documented in the n8n Changelog on October 29, 2026. As summarized in AY Automate's November 10, 2026 upgrade analysis and Pulsar Forge's November 19, 2026 field guide, 1.x support ends on December 31, 2026 with no direct upgrade path to 3.0, whereas the 2.x branch will continue receiving security and critical bug fixes for 12 months after 3.0 reaches stable availability.

flowchart TD
    A[Current n8n Instance] --> B{Current Major Version?}
    B -->|1.x EOL Dec 31, 2026| C[Upgrade to Latest 2.x First]
    B -->|2.x Stable e.g. 2.48.7| D[Run Settings > Migration Report]
    C --> D
    D --> E{Deployment Method?}
    E -->|npm or npx n8n| F[Migrate to Docker Compose + Postgres]
    E -->|Docker / K8s / Cloud| G[Fix Blocked & Failing Nodes in 2.x]
    F --> G
    G --> H[Full DB + ~/.n8n Backup]
    H --> I[Stage & Replay on 3.x Container]
    I --> J[Cut Over Production to Pinned 3.0 Tag]

Mandatory Docker Deployment and Storage Path Changes

The largest infrastructure shift in n8n 3.0 affects teams running bare-metal or VM processes via npm install -g n8n or npx n8n. Per the n8n v3.0 Breaking Changes, n8n 3.0 no longer publishes a runnable package to npm and requires a Docker-based deployment for self-hosting (Kubernetes and Helm deployments remain unaffected by the Docker CLI requirement, though all workflow and configuration rules still apply). Community node developers using n8n-node dev are similarly affected: the CLI now launches the official container image via Docker or Podman rather than npx, and stores test data in per-image container volumes (n8n-node-cli-data-<image>) rather than ~/.n8n-node-cli/.n8n because n8n database migrations only move forward.

On first boot, n8n 3.0 also renames ~/.n8n/binaryData to ~/.n8n/storage and removes N8N_MIGRATE_FS_STORAGE_PATH. Crucially, if both directories exist on disk simultaneously, n8n 3.0 refuses to start rather than guessing which directory holds active state. Operators with explicit Docker volume mounts pointing to ~/.n8n/binaryData must either update their mount target to ~/.n8n/storage or set N8N_STORAGE_PATH explicitly before starting the container.

Removed Nodes, Helpers, and Legacy AI Modes

In n8n 3.0, workflows referencing removed nodes fail at execution time, and published workflows using those nodes will not activate on startup—meaning webhooks and scheduled triggers silently stop firing. The official breaking-changes list retires:

  • Core & Scripting Nodes: Legacy Function and Function Item (replaced by the Code node in Run Once for All Items and Run Once for Each Item modes), Item Lists (split into Split Out, Aggregate, Sort, Limit, Remove Duplicates, and Summarize), Cron and Interval (replaced by Schedule Trigger), Workflow Trigger (replaced by n8n Trigger), and AI Transform (must be converted to Code via the Migration Report prior to upgrade).
  • File & Parsing Nodes: HTML Extract, iCalendar, Convert to/from binary data, Read Binary File, Read Binary Files, Write Binary File, and Read PDF (replaced by HTML, Convert to File, Extract from File, and Read/Write Files from Disk).
  • AI & Vector Store Nodes: Legacy OpenAI, OpenAI Assistant, OpenAI Model, legacy HTTP Request Tool, Manual Chat Trigger, Chat Messages Retriever, LangChain Code (no direct replacement), Motorhead and Zep memory/vector nodes (no direct replacement), SerpApi (Google Search) (no direct replacement; use HTTP Request as a tool), Binary Input Loader, JSON Input Loader, GitHub Document Loader, and split Insert/Load vector store nodes for Pinecone, Supabase, and In-Memory stores.
  • Node Versions & Helpers: AI Agent v1 (removing SQL Agent, Conversational Agent, OpenAI Functions Agent, Plan and Execute Agent, and ReAct Agent in favor of Tools Agent), Edit Image v1 and v1.1 (v2 changes the underlying image library, dropping Blur Sigma and ignoring PNG/TIFF Quality), Execute Sub-workflow Local File and URL sources, $getPairedItem (replaced by $('<node-name>').item, .itemMatching(), and .pairedItem()), and $evaluateExpression() inside JavaScript Code nodes.

Silent Behavior Changes That Do Not Throw Errors

As Pulsar Forge and AY Automate highlight, the highest operational risk in 3.0 lies in nodes that continue executing without errors while producing different downstream results:

  1. Multi-Output Always Output Data: On branching nodes such as If and Switch, enabling Always Output Data now emits an empty item only when every output branch is empty, preventing unintended fallback branches from firing.
  2. Gmail Trigger Consolidation: Versions 1.0 through 1.3 of the Gmail Trigger node now execute with 1.4 semantics—capping polls via Max Emails per Poll (default 10, max 50), skipping drafts unless Include Drafts is enabled, and ignoring sent or scheduled emails outside the inbox.
  3. Chat Trigger WebSocket Framing: In Using Response Nodes mode, the Chat Trigger WebSocket now sends structured JSON frames (heartbeat, continue, error, message, with-buttons) and expects {"type": "heartbeat-ack"} responses, requiring custom clients to parse JSON and embedded @n8n/chat widgets to be at version 1.31.0 or newer.
  4. Webflow OAuth2 Scopes: The Legacy toggle defaults to false, causing reconnected credentials without an explicit saved toggle to request Webflow v2 API scopes (cms:read, cms:write, sites:read, forms:read).

Reliability, Security, and Performance Trade-Offs

Version 3.0 shifts n8n's operational posture toward stricter isolation and bounded resource consumption. While these defaults reduce blast radius on multi-tenant or public-facing instances, they introduce immediate compatibility cliffs for long-running scripts, large archive pipelines, and internal network calls.

Parameter / Control n8n 2.x Default n8n 3.0 Default Operational Impact & Mitigation
Deployment Runtime npm, npx, Docker, K8s Docker / K8s only Bare-metal npm installs must migrate to Docker Compose
N8N_RUNNERS_TASK_TIMEOUT 300 seconds (5 min) 60 seconds (1 min) Long Code node scripts time out; set env var explicitly
N8N_UNVERIFIED_PACKAGES_ENABLED true false Custom/unverified npm community nodes stop loading
Compression Decompress Cap 2 GiB / 5,000 files 256 MiB / 1,000 files Large zip pipelines fail unless overridden via env vars
Binary Data Mode default (in-memory) filesystem In-memory mode removed; verify disk/S3/DB capacity
Encryption Key Rotation Opt-in Enabled by default Existing credentials remain readable; back up DB + key
Slack API Credential Signing secret optional Signing secret mandatory Slack Trigger workflows fail to activate without secret
SSRF Default Block List Standard private ranges Adds ::/128, 100.64.0.0/10, 2002::/16, 64:ff9b::/96 CGNAT/NAT64 internal calls fail unless allowlisted

Security Hardening: Slack, SSRF, and Secrets

In n8n 3.0, security controls move from opt-in to fail-closed. Any workflow using a Slack Trigger node will refuse to publish—and previously published workflows will fail to activate on startup—until the Signature Secret field on the Slack API credential is populated from the Slack app's Basic Information settings. Similarly, N8N_SSRF_PROTECTION_ENABLED=true with N8N_SSRF_BLOCKED_IP_RANGES=default now blocks carrier-grade NAT (100.64.0.0/10), IPv6 unspecified (::/128), 6to4 (2002::/16), and NAT64 (64:ff9b::/96) ranges. Teams calling internal microservices over Tailscale or CGNAT-backed VPNs must explicitly allowlist those ranges via N8N_SSRF_ALLOWED_IP_RANGES or N8N_SSRF_ALLOWED_HOSTNAMES rather than removing default from the block list.

On n8n Enterprise, the Enable external secrets for project roles toggle is removed, granting project editors and admins external-secrets access by default unless custom project roles are configured beforehand. Encryption key rotation is also enabled by default (manageable under Settings > Data Encryption Keys), re-encrypting records lazily on update while preserving backward readability.

Performance, Queue Workers, and Memory Limits

Three runtime changes directly affect throughput and worker sizing:

  • Task Runner Timeout (60s): Reducing N8N_RUNNERS_TASK_TIMEOUT from 300 seconds to 60 seconds prevents runaway JavaScript or Python Code nodes from starving runner pools, but batch data transformations or synchronous API loops inside Code nodes will now abort at the one-minute mark unless the timeout is raised.
  • Mandatory Worker Offload for Manual Runs: OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS is removed; in queue mode, manual test executions in the editor now always dispatch to queue workers. Platform teams must provision additional worker RAM/CPU headroom so interactive debugging does not contend with production webhook traffic.
  • Removed Pre-Execute Failure Records: N8N_PRE_EXECUTE_ERROR_CREATES_EXECUTION is removed. If a workflow.preExecute external hook throws, no execution record is created, requiring teams that monitored failed pre-execute records to emit alerts directly from the hook.

Practical Migration Workflow and Operational Gotchas

Because n8n 2.x receives security and critical bug fixes for 12 months after 3.0 stable ships, production teams should not rush early-access 3.0 builds into production. Instead, use the current 2.48.7 stable release to complete all preparatory remediation without downtime.

Step 1: Audit with the Built-In Migration Report

Available on 2.39+ under Settings > Migration Report (and improved in 2.45.4–2.46.3 with project filters, owner assignment, CSV export, and How to fix panels), the report categorizes findings into five severity tiers: Upgrade blocked, Executions will fail, Executions might fail, Behavior changes, and Capability removed. Automated migrations inside the report save fixes as new workflow versions without disturbing currently published live versions, allowing teams to remediate Function, Cron, Item Lists, and AI Transform nodes incrementally on 2.48.7.

Step 2: Pin Docker Compose and Explicit Overrides

When preparing your staging Docker Compose stack for 3.0 testing, pin explicit image tags rather than latest, update volume mounts from ~/.n8n/binaryData to ~/.n8n/storage, and declare overrides for any tightened 3.0 defaults your workloads depend on:

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n:2.48.7 # Pin exact version; test 3.x on staging first
    environment:
      - DB_TYPE=postgresdb
      - N8N_DEFAULT_BINARY_DATA_MODE=filesystem
      - N8N_RUNNERS_TASK_TIMEOUT=300 # Override 3.0's new 60s default if needed
      - N8N_UNVERIFIED_PACKAGES_ENABLED=true # Only if unverified community nodes are required
      - N8N_COMPRESSION_NODE_MAX_DECOMPRESSED_SIZE_BYTES=2147483648
      - N8N_COMPRESSION_NODE_MAX_ZIP_ENTRIES=5000
      - DB_PING_TIMEOUT_MS=5000 # Replaces removed N8N_DB_PING_TIMEOUT
    volumes:
      - n8n_data:/home/node/.n8n # Ensure no conflicting binaryData + storage dirs exist

Step 3: Back Up Before the One-Way Cutover

There is no rollback from n8n 3.0 to 2.x. Before pulling a 3.x tag on staging or production, back up both the PostgreSQL/SQLite database and the entire ~/.n8n directory (or N8N_ENCRYPTION_KEY), because saved credentials cannot be decrypted without the instance encryption key.


Frequently Asked Questions

Should production teams upgrade to n8n 3.0 right now?

No. As of November 20–21, 2026, n8n 3.0 is an early access release with stable availability expected in early December 2026, while n8n@2.48.7 is the current stable release. Teams should stay on 2.48.7, complete all Settings > Migration Report fixes, and validate workflows on a 3.x staging container before cutting over production.

Can self-hosted instances still run n8n 3.0 via npm or npx?

No. n8n 3.0 drops support for npm and npx n8n installations and does not publish a runnable n8n package to npm. Self-hosted users must migrate to a Docker-based deployment (such as Docker Compose with PostgreSQL) or Kubernetes/Helm before upgrading.

Can I roll back from n8n 3.0 to 2.x if a workflow breaks?

No. Database migrations in n8n only move forward, and downgrading from 3.0 to 2.x is not supported. Returning to 2.x requires restoring a full pre-upgrade database backup alongside your ~/.n8n encryption key.

How long will n8n 2.x and 1.x remain supported?

n8n 1.x (currently at 1.123.100) reaches end-of-life on December 31, 2026, and there is no direct upgrade path from 1.x to 3.0. n8n 2.x will receive security and critical bug fixes for 12 months after n8n 3.0 reaches stable release.

What silently breaks in n8n 3.0 even if the Migration Report is clean?

The Migration Report cannot detect every runtime shift. Teams must manually verify Slack API credentials (adding the Signing Secret), check internal HTTP calls against the expanded SSRF block list (such as 100.64.0.0/10), confirm Code node tasks finish within 60 seconds, and verify @n8n/chat embeds are at version 1.31.0 or later.


Sources

More on Automation

Automation

GitLab 19.6.1, 19.5.8, and 19.4.10 Fix Ruby2Shell (CVE-2026-132825) Ahead of November 25 PoC

On November 20, 2026, GitLab shipped critical patch releases 19.6.1, 19.5.8, and 19.4.10 bundling Ruby 3.3.14 and 3.4.13 to remediate Ruby2Shell (CVE-2026-132825) ahead of Veria Labs' planned November 25 Rails PoC release. While GitLab.com and GitLab Dedicated are already patched, self-managed CE/EE instances require an immediate upgrade—with zero migrations and no multi-node downtime.

7 min read

Automation

Elecbrakes ICSA-26-323-02: Unauthenticated BLE Flaws (CVSS 9.6) Expose Trailer Brake Controllers

On November 19, 2026, CISA issued advisory ICSA-26-323-02 warning of three critical vulnerabilities (CVSS v3 base score 9.6) in Elecbrakes EB2, VM1, and ELBC2000 trailer brake controllers. Unauthenticated Bluetooth Low Energy command injection and an unprotected firmware-update channel allow in-range attackers to alter braking or disable safety features. While EB2 3.0.4.4.3 and VM1 1.3.4.2.1 ship fixes, the discontinued ELBC2000 currently has no patch.

5 min read

Automation

libumqtt CVE-2026-125132: Unpatched Integer Underflow Exposes Five Critical OT Sectors

On November 19, 2026, CISA issued advisory ICSA-26-323-03 for an unpatched integer underflow in libumqtt 1.1.1 and earlier (CVE-2026-125132, CVSS 4.0 score 8.8). Because the repository maintainers did not respond to coordination requests, no upstream patch exists for the five critical infrastructure sectors relying on it. Here is how the flaw works and how to isolate affected OT and IoT nodes.

7 min read

Tell us what is not working

A thirty-minute call, no deck and no obligation. You will leave with a straight answer about whether this is worth building - including if that answer is no.

Start a project

Direct line

hello@codebumble.net
Dhaka, Bangladesh  :   local timeCalls in English or Bangla