From 316b2658ed3dce0ca6370dc93ce0b957a54dad0e Mon Sep 17 00:00:00 2001
From: Dean Chen <862469039@qq.com>
Date: Mon, 17 Aug 2026 20:50:50 +0500
Subject: [PATCH] docs(run): say --health-retries 0 is unset, default is 3

Signed-off-by: Dean Chen <862469039@qq.com>
---
 docs/reference/run.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/reference/run.md b/docs/reference/run.md
index 4824233685c9..53f35e7c51b3 100644
--- a/docs/reference/run.md
+++ b/docs/reference/run.md
@@ -1085,6 +1085,10 @@ for container healthchecks:
 | `--health-start-interval`  | Time between running the check during the start period                                 |
 | `--no-healthcheck`         | Disable any container-specified `HEALTHCHECK`                                          |
 
+`--health-retries` is consecutive failed checks before the container is marked
+`unhealthy`. The first check counts. The value must be 1 or higher; `0` is
+treated as unset and the daemon uses its default of 3.
+
 Example:
 
 ```console