n8n-helm

Production-oriented Helm chart for n8n — the fair-code workflow automation platform.

Quick start

helm repo add community-artifacts https://community-artifacts.github.io/n8n-helm
helm repo update
helm install n8n community-artifacts/n8n

Need a values.yaml? See the full values reference and the example overlays in the chart README.

What’s inside

Operational knobs that the upstream n8n image alone doesn’t give you — all opt-in:

Queue mode with dedicated worker, webhook, and MCP-webhook deployments
External task runners (n8nio/runners) with full image/args/env/resources overrides
Multi-main HA (main.count > 1) for enterprise license holders
Autoscaling — HPA for main and worker, KEDA-aware
PodDisruptionBudgets per role (main.pdb, worker.pdb, webhook.pdb)
S3 binary storage (binaryData.mode=s3) with optional bundled MinIO
Postgres TLS with inline base64 certs or existingSecret references
Observability — ServiceMonitor for main, PodMonitor for workers in queue + Postgres mode
Bundled subcharts — opt-in cloudpirates/postgres (PostgreSQL 18) and valkey/valkey (Redis-wire-compatible 9.x), with the option to bring your own via externalPostgresql / externalRedis
values.schema.json shipped with the chart, so helm install --set foo=bar is validated client-side

Versions

The chart’s MAJOR component tracks the n8n binary’s MAJOR (2.x ships n8n 2.x); chart-side MINOR / PATCH bumps live independently. Full changelog in RELEASE-NOTES.md.

Chart	n8n (`appVersion`)	Highlights
`2.4.0`	`2.21.4`	Hardening sweep: `networkPolicy`, `requireExplicitEncryptionKey`, per-role `terminationGracePeriodSeconds`, `extraManifests`/`extraTemplateManifests`, task-runner sidecar drift fix, HTTP `startupProbe` defaults
`2.3.0`	`2.21.4`	`taskRunners.external.launcherConfig`
`2.2.0`	`2.21.4`	Per-sidecar `securityContext` on the external task-runner
`2.1.0`	`2.21.4`	Replaced Bitnami subcharts with CloudPirates Postgres + Valkey (values-key breaking within 2.x)

Only minor-track entries (X.Y.0) are listed; patches within each minor are covered in RELEASE-NOTES.md.

# pin a specific version
helm install n8n community-artifacts/n8n --version 2.4.0

Source, issues, contributing

Chart source: https://github.com/community-artifacts/n8n-helm
Issue tracker: https://github.com/community-artifacts/n8n-helm/issues
Contributing guide: CONTRIBUTING.md
n8n project: https://github.com/n8n-io/n8n