Skip to content
LabTether

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

The LabTether agent discovers Docker automatically when installed on the same host.

  1. In LabTether, click + Add DeviceAgent
  2. Copy the install command
  3. Run it on your Docker host with sudo
  4. The device appears in Devices within seconds
  5. 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.

  1. Ensure the Docker API is exposed over TCP (e.g., on port 2375 or 2376 with TLS)
  2. In LabTether, click + Add DeviceDocker
  3. Enter the Docker API URL: tcp://your-docker-host:2375 (or https:// for TLS)
  4. Click Test ConnectionSave

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.