Hi everyone! 
I’d like to share a new integration I’ve been working on: Docker Socket Proxy.
While there are existing ways to monitor Docker, I wanted a solution that focuses on security and ease of use for modern Home Assistant setups, especially those running on separate hosts.
Why this integration? Instead of exposing the dangerous /var/run/docker.sock directly to Home Assistant, this integration communicates with Tecnativa’s Docker Socket Proxy. This keeps your Docker daemon secure while giving you full visibility.
Key Features:
Real-time Monitoring: Automatic polling of container states and health.
Security First: Designed to work through a proxy (no local socket mounting required).
Auto-Discovery: New containers show up as sensors automatically.
Health Check Support: Native parsing of Docker health statuses (healthy,unhealthy, etc.).
Service URLs: Generates clickable links in your dashboard based on container labels (e.g., ha.web_port).
Built-in Blueprint: Comes with a blueprint for instant mobile notifications if a container goes unhealthy or the host goes down.
Multi-Host Support: Monitor your NAS, VPS, and Pi all in one place.
Dashboard Power
The integration provides rich attributes (IPs, MACs, Uptime, Image version). It works great with flex-table-card to create a “Docker Zoo” overview:
Quick Start
The easiest way to install is via HACS:
- Add
https://github.com/s-t-e-f-a-n/ha_docker_socket_proxyas a custom repository. - Install & Restart.
- Add the “Docker Socket Proxy” integration via the UI.
Detailed setup instructions, including the recommended docker-compose for the proxy and dashboard YAML examples, can be found in the README:
GitHub: s-t-e-f-a-n/ha_docker_socket_proxy
I’m looking forward to your feedback and hearing about how you use it!