Connect Docker
Manage Docker containers across your homelab from LabTether.
Two paths
| Method | Best for | What you get |
|---|---|---|
| Agent (recommended) | Docker hosts you also want terminal/desktop/file access on | Full metrics, terminal, file management, container management |
| Docker API connector | Remote Docker hosts where you only need container visibility | Container list, stats, image management |
Option A: Agent (recommended)
The LabTether agent discovers Docker automatically when installed on the same host.
- In LabTether, click + Add Device → Agent
- Copy the install command
- Run it on your Docker host with sudo
- The device appears in Devices within seconds
- Docker containers are auto-discovered and appear in Containers
Option B: Docker API connector
Use this when you want container visibility without installing an agent.
- Ensure the Docker API is exposed over TCP (e.g., on port 2375 or 2376 with TLS)
- In LabTether, click + Add Device → Docker
- Enter the Docker API URL:
tcp://your-docker-host:2375(orhttps://for TLS) - Click Test Connection → Save
What you'll see
- Containers page shows all containers with status, image, ports, and per-container CPU/memory stats
- Services discovers web services running in containers
- Dashboard includes container host metrics in fleet aggregates
- Topology maps container relationships to their host
Troubleshooting
- Agent not discovering Docker: Ensure the agent user has access to the Docker socket (
/var/run/docker.sock). The install script handles this automatically. - API connector refused: Docker API isn't exposed by default. You need to configure the Docker daemon to listen on TCP.