From fd7d141ef1d3e8ac54a1d9441ee84769f4f81d06 Mon Sep 17 00:00:00 2001
From: Nicolas Vollmar <nvollmar@gmail.com>
Date: Thu, 13 Nov 2025 14:32:10 +0100
Subject: [PATCH] T6686: adds container health check documentation (#1682)

---
 docs/configuration/container/index.rst | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/docs/configuration/container/index.rst b/docs/configuration/container/index.rst
index ed70a49c..ca235521 100644
--- a/docs/configuration/container/index.rst
+++ b/docs/configuration/container/index.rst
@@ -202,6 +202,31 @@ Configuration
 
    Disable a container.
 
+Container Health checks
+=======================
+
+By default, no health checks are run, even when defined by the image.
+
+.. cfgcmd:: set container name <name> health-check
+
+    Default health check is run for the container if defined by the image.
+
+.. cfgcmd:: set container name <name> health-check command <command>
+
+    Override the default health check command from the image for a container.
+
+.. cfgcmd:: set container name <name> health check interval <interval>
+
+    Override the default health-check interval. For example: `60`
+
+.. cfgcmd:: set container name <name> health check timeout <timeout>
+
+    Override the default health-check timeout. For example: `10`
+
+.. cfgcmd:: set container name <name> health check retries <retries>
+
+    Number of health check retries before container is considered unhealthy. For example: `1`
+
 Container Networks
 ==================