Docker

Open Settings → Docker. This tab connects Home Lab to one or more Docker hosts through a socket-proxy, so it can show container status on cards and start / stop / restart containers from the UI.

Why a socket-proxy?

Home Lab never touches the Docker socket directly. Instead it talks to a tecnativa/docker-socket-proxy sidecar that exposes only a limited subset of the Docker API. This keeps the raw socket out of the dashboard's reach.

Run the proxy alongside Home Lab (see the installation compose file):

dockerproxy:
  image: tecnativa/docker-socket-proxy
  environment:
    CONTAINERS: 1
    POST: 1
    START: 1
    STOP: 1
    RESTART: 1
  volumes:
    - /var/run/docker.sock:/var/run/docker.sock:ro

Configure the connection

In the Docker tab, add a proxy entry:

Field	Example
Name	local
URL	http://dockerproxy:2375
Enabled	toggle on

Add multiple proxies to manage containers across several hosts.

Linking cards to containers

Set a service's Container field (in the service dialog) to the container's name. The card's status dot then reflects the container's real state.

Controls

Once a proxy is connected, the Docker tab lists containers with start / stop / restart actions. Destructive actions ask for confirmation before running.

Permissions

Only enable the proxy capabilities you need (START, STOP, RESTART, POST). The proxy mounts the socket read-only and gates everything else off.

Next steps

• Services & cards
• Installation