You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Docker provides built-in support for container health checks through its daemon, allowing users to monitor container health and take automated actions like restarts. nerdctl currently lacks native health check support, which limits its ability to support similar workflows—especially when running containers defined via Dockerfiles or Compose files that include health check instructions. This feature aims to close that gap by enabling health checks in a way that aligns with nerdctl’s daemonless design.
Describe the solution you'd like
We’d like to propose adding health check support in nerdctl, similar to what Docker offers, but designed to work in nerdctl’s daemonless architecture. This feature will enable users to define and run application-level health checks using:
Health check configuration defined in Dockerfiles (HEALTHCHECK instruction)
Health checks defined in Compose files
As part of this support, we will introduce a new subcommand:
nerdctl healthcheck run <container>
This command acts as the entry point for performing the health check—it runs the configured health check command inside the container and determines the result.
Since nerdctl does not have a persistent daemon like Docker, we use systemd to invoke this command at the configured intervals, effectively handling the scheduling aspect externally.
[#4302] only adds support for healthcheck option in nerdctl run, nerdctl create, and introduces a new nerdctl container healthcheck command. However, periodic execution of health checks against running containers is still WIP.
This issue tracks the overall healthcheck support in nerdctl, so we should keep it open.
Activity
swagatbora90 commentedon Apr 24, 2025
Related #2386, runfinch/finch#494
apostasie commentedon Jun 23, 2025
Is this complete with #4302?
swagatbora90 commentedon Jun 24, 2025
[#4302] only adds support for healthcheck option in nerdctl run, nerdctl create, and introduces a new nerdctl container healthcheck command. However, periodic execution of health checks against running containers is still WIP.
This issue tracks the overall healthcheck support in nerdctl, so we should keep it open.
swagatbora90 commentedon Sep 24, 2025
This issue can be closed now since both the healthcheck command implementation and orchestration PRs are merged now.
tom-rm-meyer-ISST commentedon Sep 25, 2025
Cool, if I see things correctly, this is part of version 2.1.3, isn't it?
swagatbora90 commentedon Sep 25, 2025
Healthcheck command was added in 2.1.3. Orchestration PR was recently merged #4427 and will be available in the next 2.1.5 release.