Skip to content

fix: default readiness probe to /healthz/readiness#149

Merged
krider2010 merged 2 commits into
n8n-io:mainfrom
HlsRobot:fix/readiness-probe-healthz-readiness
Jun 15, 2026
Merged

fix: default readiness probe to /healthz/readiness#149
krider2010 merged 2 commits into
n8n-io:mainfrom
HlsRobot:fix/readiness-probe-healthz-readiness

Conversation

@HlsRobot

@HlsRobot HlsRobot commented Jun 2, 2026

Copy link
Copy Markdown
Contributor

Description

Changes the default probes.readiness.path in values.yaml from /healthz
to /healthz/readiness.

Why

  • /healthz only checks that the n8n process is running (process-alive check)
  • /healthz/readiness checks that n8n is actually ready to serve traffic —
    it verifies DB connectivity and (in queue mode) Redis connectivity
  • Using /healthz for readiness means pods are marked ready before they can
    actually handle requests, causing errors during startup/rolling updates

Backwards compatibility

The path is fully configurable. Users who prefer the old behaviour can set:

probes:
  readiness:
    path: /healthz

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update
  • Example/configuration update
  • CI/CD improvements

Changes Made

Just the value of the readiness path at the values.yaml to check the DB at the readiness checks.

The /healthz/readiness endpoint performs a deeper check (verifies DB
and queue connectivity) making it more accurate as a readiness signal.
/healthz only checks that the process is alive, which is better suited
for the liveness probe.

The path remains configurable via probes.readiness.path so operators
can revert to /healthz if preferred.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 1 file

Re-trigger cubic

@krider2010 krider2010 merged commit d7d2988 into n8n-io:main Jun 15, 2026
10 checks passed
krider2010 added a commit that referenced this pull request Jun 15, 2026
Add context under the #149 entry: pods now wait for DB connectivity
and migrations before becoming Ready, and how to revert via
probes.readiness.path.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants