Files
dozzle/docs/guide/hostname.md
T
2026-04-23 12:42:49 -07:00

34 lines
1.2 KiB
Markdown

---
title: Hostname
---
# Changing Dozzle's Hostname
Dozzle's default connection is called localhost. Using the `--hostname` flag, Dozzle's name can be changed to anything. This value will be shown on the page title and under the Dozzle logo.
Changing the label for localhost also changes the label for the `localhost` connection which is displayed under the multi-host menu. Below is an example of using `--hostname` to change the name of Dozzle's subheader to `mywebsite.xyz`.
::: code-group
```sh
docker run --volume=/var/run/docker.sock:/var/run/docker.sock -p 8080:8080 amir20/dozzle --hostname mywebsite.xyz
```
```yaml [docker-compose.yml]
services:
dozzle:
image: amir20/dozzle:latest
volumes:
- /var/run/docker.sock:/var/run/docker.sock
ports:
- 8080:8080
environment:
DOZZLE_HOSTNAME: mywebsite.xyz
```
:::
## Multi-Host and Agents
`--hostname` only relabels the host running **this** Dozzle process. Remote [agents](/guide/agent) advertise their own names — set `DOZZLE_HOSTNAME` (or `--hostname`) on each agent to control how it appears in the multi-host menu. In [swarm mode](/guide/swarm-mode) each node runs its own agent, so give each node a distinct hostname to tell them apart.