Update n8nio/n8n Docker tag to v2.27.3#3468
Conversation
Triage: GREEN -- safe to mergeMinor version bump with comprehensive release notes, database migration is non-destructive and well-documented, and provenance is from the expected publisher with no supply chain indicators. Quick summaryThis is a minor version bump from Updates table
Required actionsNone -- safe to merge. Monitor pod startup after deploy to ensure the 2.27.0 database migration completes within the liveness probe window (currently Update summary
|
| Surface | Value |
|---|---|
| Image | n8nio/n8n:2.27.3@sha256:a772d24e6b4f9b3848be5a57c5e45437eed1965bbbcefa2f9a93f4835b6639fa |
| Workload type | StatefulSet (via kustomize/workloads/statefulset/statefulset.yaml) with Linkerd mesh injection |
| Namespace | n8n |
| Security context | runAsUser: 10001, runAsGroup: 10001, fsGroup: 10001, readOnlyRootFilesystem: false |
| Key env vars | DB_TYPE=postgresdb, DB_POSTGRESDB_HOST=rpi4.anshulg.direct, DB_POSTGRESDB_PORT=5432, DB_POSTGRESDB_DATABASE=n8n, DB_POSTGRESDB_USER=n8n, DB_POSTGRESDB_SCHEMA=public, DB_POSTGRESDB_SSL_ENABLED=true, DB_POSTGRESDB_SSL_REJECT_UNAUTHORIZED=false, DB_POSTGRESDB_SSL_CA=/etc/ssl/certs/ca-certificates.crt, N8N_HOST=n8n.anshulg.net, N8N_PORT=5678, N8N_PROTOCOL=https, N8N_USER_FOLDER=/data, N8N_RUNNERS_ENABLED=true, N8N_RESTRICT_FILE_ACCESS_TO=/data/.n8n-files, N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true, N8N_PROXY_HOPS=1, WEBHOOK_URL=https://n8n.anshulg.net/, TZ=America/Los_Angeles |
| Secrets | DB_POSTGRESDB_PASSWORD (SealedSecret n8n/secrets) |
| Volume mounts | /data (PVC data, 5Gi RWO), /etc/ssl/certs/ca-certificates.crt (ConfigMap anshulg-ca), /tmp (emptyDir) |
| Probes | liveness + readiness: GET /healthz:5678; readiness: initialDelaySeconds: 10, periodSeconds: 10; liveness: initialDelaySeconds: 30, periodSeconds: 30 |
| Resources | requests: 100m CPU / 256Mi RAM; limits: 1Gi RAM (no CPU limit) |
| Ingress | Traefik IngressRoute → n8n.anshulg.net (TLS, public), n8n.internal (direct-ingress, cluster-internal) |
N8N_CROSS_ORIGIN_OPENER_POLICY |
not set — will adopt new default (net improvement for OAuth flows) |
Cluster fit
- Architectures required by cluster:
amd64(primary nodes),arm64(rpi5 nodes) - Architectures supported by new version:
linux/amd64✅ andlinux/arm64✅ — n8n's CI consistently produces multi-arch manifests for all2.xrelease builds; the2.27.xseries follows the same pattern as2.26.x - Kubernetes API versions used in manifest sources:
apps/v1(StatefulSet),v1(Service, ConfigMap, Secret, PVC),bitnami.com/v1alpha1(SealedSecret),traefik.io/v1alpha1(IngressRoute) — all standard, no deprecated APIs - Minimum K8s version stated by dep: not stated (plain container image, no K8s version constraint)
- Peer dependency check: SealedSecret controller, Traefik IngressRoute CRD, and Linkerd mesh injection all unchanged and unaffected by this image bump. No new CRD requirements introduced.
Gaps
- Rendering gap: Kustomize stack not rendered locally (no tooling available). Deployment fingerprint assembled by reading all referenced base/component/patch files directly. Considered complete for this analysis.
- Execution table size unknown: The severity of the F1 migration delay depends on the number of rows in
execution_entity. Cannot be determined from manifests. If the instance has been running for a long time with many workflows, index creation could take longer than theinitialDelaySeconds: 30liveness probe window, potentially causing a restart loop. - Architecture confirmation for exact digest
sha256:a772d24e...: Architecture support confirmed via Docker Hub tag listing patterns and CI workflow inspection rather than direct manifest inspection of the specific digest. - No
BREAKING-CHANGES.mdentry for 2.27.x: The n8n repo'sBREAKING-CHANGES.mdhas no entry for this range. Release notes treated as authoritative. - Prior analysis note: The existing bot comment covers
2.26.7 → 2.27.2in full. The2.27.3increment adds only 2 pure bug fixes (Form Trigger Node crash fix, UI preview suggestions hide on small screens) with zero deployment surface impact. The delta between the prior analysis and this one is limited to those two fixes.
Upstream changelog
All four releases retrieved. I have complete information for the full range. Let me compile the structured output.
n8nio/n8n 2.26.7 → 2.27.3
Summary
- Artifact type: Container image (Docker Hub
n8nio/n8n), backed by source repogithub.com/n8n-io/n8n - Input format: SemVer minor/patch versions
- Resolved references: Tag
n8n@2.26.7→ tagn8n@2.27.3ongithub.com/n8n-io/n8n - Versions in range: 2.27.0 (2026-06-16), 2.27.1 (2026-06-17), 2.27.2 (2026-06-18), 2.27.3 (2026-06-19)
- Source repo: https://github.com/n8n-io/n8n
- Primary sources used: GitHub Releases — https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0, https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.1, https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.2, https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.3
- Versioning scheme: SemVer (minor bump 2.26 → 2.27; n8n treats minor bumps as feature releases, not breaking-change signals)
- Major version boundary crossed: No (2.x → 2.x)
- Confidence: High — maintainer-authored release notes cover all four intermediate versions with full commit-level detail
Breaking Changes
Database migration on startup — index added to execution_entity table
- What changed: A new partial index is added to the
execution_entitytable on first startup after upgrade; on large instances this migration may take several minutes to complete. - Affects: Startup time / availability window; database schema (PostgreSQL, MySQL, SQLite all affected). No schema removal or API change — purely additive, but the migration runs automatically and cannot be skipped.
- Migration: No manual action required. The release notes state: "the database remains available during the process" — the instance will be temporarily unresponsive until the migration completes. Operators should plan for an extended startup window on large deployments.
- Source: https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0 (release notes header, PR #32116)
- Confidence: documented
- Introduced in: 2.27.0
COOP header default value changed
- What changed: The default value of the Cross-Origin-Opener-Policy (
COOP) HTTP response header was changed. - Affects: Browser security policy / OAuth popup flows; any deployment relying on the previous default COOP value (e.g.,
same-origin) may see OAuth credential authorization popups break or browser cross-origin isolation behavior change. - Migration: Not explicitly documented beyond the fix description. Operators with custom reverse-proxy COOP overrides should verify their configuration. The change was introduced as a bug fix (PR #32388) — the prior default was considered incorrect.
- Source: https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.1 (PR #32388)
- Confidence: inferred (labeled as bug fix, but a default header value change affects all deployments that did not explicitly set the header)
- Introduced in: 2.27.1
user:enforceMfa scope removed from public API key scopes
- What changed: The
user:enforceMfascope was removed from the set of valid public API key scopes. - Affects: Public API — any API key that was granted
user:enforceMfascope, or any automation that programmatically requests or checks for this scope. - Migration: Not documented. API keys with this scope will lose it; callers relying on it must use an alternative mechanism (admin UI or a different scope).
- Source: https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0 (PR #32223)
- Confidence: inferred (scope removal from a public API is a breaking change for consumers of that scope)
- Introduced in: 2.27.0
API key scope/endpoint parity enforced in public API
- What changed: API key scope enforcement was tightened so that scopes and accessible endpoints are kept in strict parity; previously some endpoints may have been accessible without the correct scope.
- Affects: Public API — existing API keys that relied on under-enforced scope checks may now receive 403 responses on previously accessible endpoints.
- Migration: Not documented. Audit existing API key scopes and ensure they include all required scopes for the endpoints they call.
- Source: https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0 (PR #32231)
- Confidence: inferred (enforcement tightening is a behavioral breaking change for callers relying on the prior lax behavior)
- Introduced in: 2.27.0
Form Trigger Node: missing authentication parameter default causes crash on old workflows
- What changed: Old workflows using the Form Trigger Node without an explicit
authenticationparameter value would crash; 2.27.3 adds a default value to prevent this. - Affects: Form Trigger Node — workflows created before the
authenticationparameter was introduced. The crash was introduced somewhere in the 2.27.x line and is fixed in 2.27.3. - Migration: No action required after upgrading to 2.27.3; the fix is automatic. Operators who deployed 2.27.0–2.27.2 with affected workflows should upgrade to 2.27.3 promptly.
- Source: https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.3 (PR #32628)
- Confidence: documented (explicitly described as preventing a crash on old workflows)
- Introduced in: regression introduced in 2.27.x, fixed in 2.27.3
Other Notable Changes
2.27.0 — Features:
- S3 storage mode for execution data (
core): New option to store execution binary data in S3 instead of the database/filesystem. PR #32226. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0 - Data redaction enforcement GA (
core): Output redaction guardrail for Instance AI is now generally available (previously feature-flagged). PR #31966. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0 - MCP Server Trigger Node: Added n8n OAuth2 authentication option. PR #32326. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0
- Kafka Node: New Schema Registry credential type added; Schema Registry credential is now distinguished from the Kafka credential. PRs #32026, #32335. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0
- OpenTelemetry: Settings now configurable via UI; test trace endpoint added. PRs #31781, #32333. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0
- MCP server: Tags support added. PR #31446. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0
- Workflow import: New
workflowIdPolicyandworkflowPublishingPolicyoptions for package import. PRs #32075, #31961. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0 credentialBindingsfor package import (core). PR #32228. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0- Microsoft OneDrive Node: Now supports generic Microsoft OAuth2 credential. PR #32295. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0
- Force Microsoft account selection on OAuth for all Microsoft credentials. PR #32015. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0
- LmChatAnthropic Node: Streaming option added. PR #30991. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0
- JWT Node: Custom header claims support for Sign operation. PR #31918. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0
- GitHub Node: New "get members" operation on organization resource. PR #23822. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0
- Pipedrive Trigger Node: Lead entities can now be triggered upon. PR #23977. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0
explore_node_resourcesMCP tool added. PR #31018. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0- n8n packages license check removed (
core). PR #32317. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0 - RFC 8707 resource parameter added to client-side OAuth flow. PR #30924. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0
- Prometheus metrics: DNS cache metrics and SSRF protection check outcomes now exposed. PRs #32013, #32004. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0
2.27.0 — Security fixes:
- Fixed 4 security issues in
@grpc/grpc-jsandhono. PR #32281. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0 - Fixed security issue in
shell-quote(1.8.3 → 1.8.4, SEC-809). PR #32107. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0 - Bumped
task-runner-launcherto 1.4.7 to clear stdlib CVEs. PR #32095. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0 - Upgraded
nodemailerto 8.0.10. PR #31998. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0
2.27.0 — Performance:
- Partial index on
execution_entityto fix executions list CPU spike. PR #32116. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0 - Optimized workflow lookups. PR #24690. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0
- Ungated minimize execution data fetching. PR #30969. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0
2.27.1 — Features:
- MCP and OAuth server IP rate limits now configurable via environment variables. PR #32454. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.1
2.27.1 — Bug fixes:
- Suspend query acquisition during database connection recovery. PR #32466. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.1
2.27.2 — Bug fixes:
- Compression Node: Decompress only archive members (not the archive itself). PR #32516. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.2
- Workflow-folder-conflict handling in import process. PR #32416. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.2
2.27.3 — Bug fixes:
- Hides preview suggestions on smaller screens. PR #32561. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.3
Deprecations Introduced
- Calendly Trigger Node — API key auth deprecated: API key authentication is deprecated; OAuth2 is now the default. Existing Calendly Trigger nodes using API key auth continue to function but should be migrated to OAuth2. No scheduled-removal version stated. PR #28367. https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.0
Gaps and Caveats
- No dedicated migration guide: n8n does not publish a separate
UPGRADING.mdor migration guide for minor releases. All information is sourced from GitHub Release notes only. - COOP header change specifics not documented: PR #32388 is described only as "Change default value of the COOP header" — the old and new values are not stated in the release notes. Downstream agent should inspect the PR diff if the exact header values are needed.
- Form Trigger crash window: The Form Trigger Node crash (fixed in 2.27.3) was present in 2.27.0–2.27.2. Deployments that ran any of those intermediate versions with affected workflows may have experienced silent failures. The fix is in the target version (2.27.3) so no residual risk after upgrade.
- All 2.27.x releases are marked
prerelease: truein the GitHub API — this is n8n's standard tagging pattern for the rolling minor series before a stable tag is cut; it does not indicate instability relative to the 2.26.x series. user:enforceMfascope removal: The PR description (#32223) was not inspected at the diff level; the impact on existing API keys with this scope is inferred from the removal description.
Provenance
Excellent! Now I have all the information I need. Let me compile the provenance verdict based on my findings.
Provenance verdict: n8nio/n8n 2.26.7 → 2.27.3
Verdict
trusted
Both versions are legitimate releases from the n8n project with proper source correspondence, consistent publisher identity, and no indicators of supply chain compromise.
Resolved references
- Artifact type: OCI container image (Docker Hub
docker.io/n8nio/n8n) - Old:
n8nio/n8n:2.26.7(GitHub releasen8n@2.26.7, published 2026-06-18T10:41:53Z) - New:
n8nio/n8n:2.27.3(GitHub releasen8n@2.27.3, published 2026-06-19T10:47:54Z) - Declared source repo:
https://github.com/n8n-io/n8n(verified) - Publisher namespace:
n8nio(old) →n8nio(new) — same
Indicators
| Severity | Category | Finding | Evidence |
|---|---|---|---|
| info | source_correspondence | Old version has matching GitHub release and commit | Release n8n@2.26.7 published 2026-06-18T10:41:53Z; commit 8ee27e81a67f75da665e6f88921c80ea18dda134 |
| info | source_correspondence | New version has matching GitHub release and commit | Release n8n@2.27.3 published 2026-06-19T10:47:54Z; commit 4d5251d388764883b0b817fb9fd5cb27df629f11 |
| info | publisher_continuity | Publisher namespace unchanged | Both versions published under n8nio on Docker Hub |
| info | publisher_continuity | Release authored by n8n-assistant[bot] | Automated release process consistent across both versions |
| info | external_signal | Release notes present and detailed | Both versions have comprehensive changelogs documenting changes |
Source ↔ artifact correspondence
- Old version anchor: GitHub release
n8n@2.26.7(https://github.com/n8n-io/n8n/releases/tag/n8n%402.26.7) with commit8ee27e81a67f75da665e6f88921c80ea18dda134 - New version anchor: GitHub release
n8n@2.27.3(https://github.com/n8n-io/n8n/releases/tag/n8n%402.27.3) with commit4d5251d388764883b0b817fb9fd5cb27df629f11 - Method: GitHub release tag matching; commits verified on source repository
Both versions have corresponding GitHub releases with proper version tags and documented release notes. The release commits are present on the source repository, confirming legitimate source-to-artifact correspondence.
Signatures and attestations
| Old | New | |
|---|---|---|
| Cosign signature present | unknown | unknown |
| Signing identity | n/a | n/a |
| SLSA provenance present | unknown | unknown |
| Builder identity | n/a | n/a |
| SBOM attached | unknown | unknown |
Note: Docker Hub rate limiting prevented direct skopeo inspection of image manifests. Signature and attestation presence could not be verified. However, both versions follow the same release pattern (automated releases by n8n-assistant[bot]), suggesting consistent practices.
Metadata drift
No metadata drift detected. Both versions:
- Published by the same bot account (
n8n-assistant[bot]) - Released from the same repository (
n8n-io/n8n) - Follow the same release tagging convention (
n8n@X.Y.Z) - Include comprehensive changelogs documenting all changes
Changes between versions (2.26.7 → 2.27.3) are documented in release notes:
- 2.27.3: 2 bug fixes (Form Trigger Node, preview suggestions)
- 2.27.2: 2 bug fixes + 1 performance improvement
- 2.27.1: 4 bug fixes + 1 feature + 1 performance improvement
- 2.27.0: Major release with database migration, numerous features and fixes
All documented changes are consistent with normal development progression.
Typosquat / confusable check
- Nearest popular alternative names checked:
n8n(official),n8nio(official publisher),n8n-io(GitHub org) - Findings: None. The
n8nionamespace on Docker Hub is the official publisher for n8n. No confusable alternatives detected.
Repo health
- Ownership transfer in last 90d: No evidence of transfer. Repository remains under
n8n-ioorganization. - Archived: No. Repository is active with regular releases.
- New committers in version range: Release commits authored by
n8n-assistant[bot](automated). Underlying code changes authored by established contributors (Matsuuu, Garrit Franke, Bernhard Wittmann, etc.) with prior history in the repository. - Workflow file changes affecting release pipeline: No anomalies detected. Releases follow consistent automated pattern.
Gaps
- Cryptographic signature verification: Docker Hub rate limiting prevented skopeo inspection of image manifests. Cosign signature presence and validity could not be verified. Full cryptographic verification would require authenticated access to Docker Hub or cosign CLI with proper credentials.
- Image manifest inspection: Rate limiting prevented direct inspection of OCI image config, labels, and layer digests. Metadata drift analysis limited to release notes and GitHub metadata.
- SLSA provenance: Could not verify presence or validity of SLSA provenance attestations on image manifests.
These gaps do not change the verdict, as source-to-artifact correspondence is verified through GitHub releases and commits, and publisher continuity is confirmed through consistent release patterns and repository metadata.
24ebd63 to
18068b8
Compare
5f4892e to
c26279f
Compare
c26279f to
c40c7c3
Compare
c40c7c3 to
16e0755
Compare
This PR contains the following updates:
2.26.7→2.27.3Warning
Some dependencies could not be looked up. Check the Dependency Dashboard for more information.
Release Notes
n8n-io/n8n (n8nio/n8n)
v2.27.0Bug Fixes
context.getNodeParameter is not a functionwhen n8n is installed via npm (#32123) (a254a89)Features
Performance Improvements
Configuration
📅 Schedule: (in timezone America/Los_Angeles)
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR was generated by Mend Renovate. View the repository job log.