# Dozzle Agent

Dozzle Agent is a companion for the Dozzle Docker log viewer that connects a remote Docker host to a central Dozzle instance. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/6768/dozzle-agent

## Description

Dozzle Agent is a companion for the Dozzle Docker log viewer that connects a remote Docker host to a central Dozzle instance. Install one agent per remote machine and the main Dozzle UI shows its container logs and live stats alongside your local ones, so you can watch every host from a single dashboard. It is for anyone running Docker on several hosts who wants lightweight centralized log viewing without a full logging stack. Out of the box the agent uses a self-signed certificate, which is fine on a private network. Set the Dozzle Hostname option to give the host a friendly name in the main UI. If you only run one host, use the regular Dozzle template instead of an agent.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

78/100 (Good), based on 3 of 4 factors.
- Maintained: 100 (last commit 1 day ago)
- Popular: 84 (14,989 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/dozzle-agent-1vt7ypr0wl4twj?q=dozzle-agent
- GitHub: https://github.com/amir20/dozzle
- Official website: https://dozzle.dev/
- Documentation: https://dozzle.dev/guide/swarm-mode

## Common questions

### How should I restrict access to a Dozzle Agent?

The agent is only as private as the network it listens on, and the certificate shipped in the image is the same in every copy. It encrypts the connection but does not prove who is on the other end, so anyone who can reach port 7007 can connect their own Dozzle to the agent and read logs.

### Does Dozzle Agent keep log history for later search?

No, Dozzle does not store log files and is designed purely for live log viewing. It does not support offline searching.

### How does Dozzle identify a Docker host?

In Swarm mode, Dozzle uses the node ID from docker system info to identify the host. If you are not using Swarm mode, Dozzle uses the system ID from docker system info as the host ID.

### Should I enable the shell and container action buttons?

Leave DOZZLE_ENABLE_SHELL and DOZZLE_ENABLE_ACTIONS commented out unless you want visitors to run commands or control containers. If left on, a mistaken click or an untrusted user can stop, start, or restart containers from the web page.

### Which port should I expose for the Dozzle web UI?

Expose port 8080 for the web page and mount /var/run/docker.sock so Dozzle can see the Docker daemon. Without the socket mount, Dozzle cannot list containers or show logs, and without port 8080 you cannot open the dashboard.

---
Source: Our Local Host (https://ourlocalhost.com/app/6768/dozzle-agent), the self-hosted and open-source app directory.
