From 30b528c49180620d7beccc4ff83ec72fa09131d6 Mon Sep 17 00:00:00 2001 From: Aarnav Tale Date: Sat, 30 May 2026 18:47:57 -0400 Subject: [PATCH] docs(install): use CMD prefix in Docker healthcheck example MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Docker Compose requires the test array to start with NONE, CMD, or CMD-SHELL. The previous example was missing the prefix, so Compose treated the binary path as the shell command, the healthcheck was rejected, and the container was marked unhealthy — which causes Traefik (and similar) to skip it. Closes #535 Amp-Thread-ID: https://ampcode.com/threads/T-019e7ae4-6862-760c-a3e7-239350eab71d Co-authored-by: Amp --- CHANGELOG.md | 1 + docs/install/docker.md | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 7184302..d170534 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,7 @@ - **Made Headscale boot resilient.** Headplane now boots even when Headscale is unreachable; capabilities default permissively and a background retry settles them once Headscale responds. No more cold-start ordering problems with docker-compose. - Fixed user-management actions (link, change role, transfer ownership) using the wrong ID type for unlinked Headplane users. Form fields are now explicitly `headplane_user_id` vs `headscale_user_id`, and the auth layer no longer round-trips through Headscale to recover the OIDC subject. - Fixed dialog panels growing beyond the viewport; dialog content is now constrained and scrollable (via [#556](https://github.com/tale/headplane/pull/556)). +- Corrected the Docker healthcheck example in the docs to use the required `CMD` prefix so reverse proxies don't see the container as unhealthy (closes [#535](https://github.com/tale/headplane/issues/535)). --- diff --git a/docs/install/docker.md b/docs/install/docker.md index 5c31b7e..1e8ed8c 100644 --- a/docs/install/docker.md +++ b/docs/install/docker.md @@ -57,7 +57,7 @@ services: headplane: image: ghcr.io/tale/headplane:latest healthcheck: - test: ["/bin/hp_healthcheck"] + test: ["CMD", "/bin/hp_healthcheck"] interval: 30s timeout: 5s start_period: 5s