sincecutoff.com
← all changes

nerdctl healthchecks support start interval across run, create, Compose, and images

Introduced 2026-10-30 · score 0.98

HOW TO USE IT

When configuring a container healthcheck, set its start interval with `--health-start-interval` on `nerdctl run` or `nerdctl create`; the setting is also supported in Compose and image healthchecks.

nerdctl run -d --health-cmd="./health-check.sh" --health-interval=30s --health-start-period=60s --health-start-interval=5s <image>
nerdctl compose up -d

WHY THIS HELPS

Set a healthcheck start interval for a container in a command, Compose configuration, or image build.

REQUIREMENTS AND LIMITATIONS

  • Version: v2.4.2
  • --health-start-interval: Time between healthchecks during the start period; default 5s.
  • healthcheck.start_interval: Compose healthcheck start interval.
  • Prerequisite: Healthcheck configuration requires nerdctl >= 2.1.5.

FIRST-PARTY EVIDENCE

Check the installed version and the source before using it. Entry JSON

Report a problem with this card