From 64e8ec48e462c48c50f1c05a186cb1daa535ad0f Mon Sep 17 00:00:00 2001 From: Amir Raminfar Date: Sat, 13 Jul 2024 14:45:28 -0700 Subject: [PATCH] docs: adds warning for duplicate hosts --- docs/guide/agent.md | 3 +++ docs/guide/remote-hosts.md | 3 +++ 2 files changed, 6 insertions(+) diff --git a/docs/guide/agent.md b/docs/guide/agent.md index af00aba1..e5c3f4b7 100644 --- 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 index db2b07c6..3fbe0608 100644 --- 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.