{
  "slug": "nerdctl-healthchecks-support-start-interval-across-run-create-compose-and-images-ad0f8207d2fc",
  "title": "nerdctl healthchecks support start interval across run, create, Compose, and images",
  "tools": [
    "nerdctl"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-10-30T12:04:04.000Z",
  "announced_at": "2026-10-30T12:04:04.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "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.",
    "examples": [
      "nerdctl run -d --health-cmd=\"./health-check.sh\" --health-interval=30s --health-start-period=60s --health-start-interval=5s <image>",
      "nerdctl compose up -d"
    ],
    "gotchas": [
      "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."
    ]
  },
  "why_it_matters": "Set a healthcheck start interval for a container in a command, Compose configuration, or image build.",
  "sources": [
    "https://github.com/containerd/nerdctl/releases/tag/v2.4.2",
    "https://github.com/containerd/nerdctl/blob/v2.4.2/docs/healthchecks.md",
    "https://github.com/containerd/nerdctl/blob/v2.4.2/docs/compose.md"
  ],
  "rank": 0.98033,
  "review_state": "approved",
  "provenance": {
    "run_id": "daily-20261030-12",
    "verdict_id": "daily-20261030-12:daily-20261030-12-ed783c2cec565afc-3:gate",
    "evidence_hash": "96f0bdea051e77eafee3501571a1cd22984ee80a5ad7aa4b4e782266a766e2ca"
  }
}