diff --git a/docs/install/docker.md b/docs/install/docker.md
index 63bc5cd7b9..31a7628c7a 100644
--- a/docs/install/docker.md
+++ b/docs/install/docker.md
@@ -8,11 +8,16 @@ You can install and run Coder using the official Docker images published on
 - Docker. See the
   [official installation documentation](https://docs.docker.com/install/).
 
-- A Linux machine. For macOS devices, start Coder using the
-  [standalone binary](./cli.md).
+- A Linux host.
 
 - 2 CPU cores and 4 GB memory free on your machine.
 
+> [!IMPORTANT]
+> This guide is for **Linux** hosts only. The `getent` and `--group-add`
+> Docker socket patterns used below are Linux-specific and do not translate
+> cleanly to macOS Docker runtimes. For macOS, install Coder using the
+> [standalone binary](./cli.md) instead.
+
 <div class="tabs">
 
 ## Install Coder via `docker compose`