installation

Installation

Via HACS (recommended)

1. Open HACS in Home Assistant
2. Go to Integrations
3. Click ⋮ → Custom repositories
4. Add URL: https://github.com/bartkodden/HA-Docker-Manager
5. Category: Integration
6. Click Add → search Docker Manager → Install
7. Restart Home Assistant

Manual

1. Download the latest release from GitHub
2. Copy custom_components/docker_manager to your HA custom_components folder
3. Restart Home Assistant

Enable TCP on remote servers

Standard Linux (Ubuntu/Debian/Pi)

Edit /etc/docker/daemon.json:

{
  "hosts": ["unix:///var/run/docker.sock", "tcp://0.0.0.0:2375"]
}

Create a systemd override:

sudo mkdir -p /etc/systemd/system/docker.service.d
sudo tee /etc/systemd/system/docker.service.d/override.conf << EOF
[Service]
ExecStart=
ExecStart=/usr/bin/dockerd
EOF

sudo systemctl daemon-reload
sudo systemctl restart docker
curl http://localhost:2375/version

Synology NAS (DSM)

Edit /var/packages/ContainerManager/etc/dockerd.json (SSH required):

{
  "data-root": "/var/packages/ContainerManager/var/docker",
  "log-driver": "db",
  "registry-mirrors": [],
  "seccomp-profile": "unconfined",
  "storage-driver": "btrfs",
  "hosts": ["unix:///var/run/docker.sock", "tcp://0.0.0.0:2375"]
}

Then restart Container Manager:

sudo synoservice --restart pkgctl-ContainerManager
curl http://localhost:2375/version

⚠️ Synology DSM updates may overwrite this file. Re-apply after DSM updates.

⚠️ Port 2375 is unauthenticated TCP. Only use on trusted LAN networks.