docs: adds warning for duplicate hosts

archiveproject · Jul 13, 2024 · 64e8ec4 · 64e8ec4
1 parent e9ceff0
commit 64e8ec4
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 0 deletions.
diff --git a/docs/guide/agent.md b/docs/guide/agent.md
@@ -64,6 +64,9 @@ Note that when connecting remotely, you don't need to mount local Docker socket.
 > [!TIP]
 > You can connect to multiple agents by providing multiple `DOZZLE_REMOTE_AGENT` environment variables. For example, `DOZZLE_REMOTE_AGENT=agent1:7007,agent2:7007`.
 
+> [!WARNING]
+> Dozzle uses the Docker API to gather information about the containers. Agents use Docker's system ID or node ID to identify the host. If you are using swarm mode, then the node ID is used. If you are seeing duplicate hosts error in the logs, then you may have duplicate hosts in configred that with the same host ID. To fix this, remove `/var/lib/docker/engine-id` file. See [FAQ](/guide/faq#i-am-seeing-duplicate-hosts-error-in-the-logs-how-do-i-fix-it) for more information.
+
 ## Setting up healthcheck
 
 You can set a healthcheck for the agent, similar to the healthcheck for the main Dozzle instance. When running in agent mode, healthcheck checks agent connection to Docker. If Docker is not reachable, the agent will be marked as unhealthy and will not be shown in the UI.

diff --git a/docs/guide/remote-hosts.md b/docs/guide/remote-hosts.md
@@ -87,6 +87,9 @@ services:
 
 :::
 
+> [!WARNING]
+> Dozzle uses the Docker API to gather information about the containers. Clients use Docker's system ID or node ID to identify the host. If you are using swarm mode, then the node ID is used. If you are seeing duplicate hosts error in the logs, then you may have duplicate hosts in configred that with the same host ID. To fix this, remove `/var/lib/docker/engine-id` file. See [FAQ](/guide/faq#i-am-seeing-duplicate-hosts-error-in-the-logs-how-do-i-fix-it) for more information.
+
 ## Changing localhost label
 
 `localhost` is a special connection and uses different configuration than `--remote-host`. Changing the label for localhost can be done using the `--hostname` or `DOZZLE_HOSTNAME` env variable. See [hostname](/guide/hostname) page for examples on how to use this flag.