Home Assistant integration for managing Docker container updates via the Dockge REST API.
Monitor update availability across all your Docker stacks, toggle auto-updates per stack, and trigger updates — all from within Home Assistant.
- Update monitoring — per-stack and per-container binary sensors for available image updates
- Container status — sensors showing each container's state (running, exited, etc.) with image and health details
- Auto-update control — per-stack switches to enable/disable automatic updates
- Update actions — buttons to update individual stacks, check for updates, update all, or trigger a scheduled run
- Scheduler status — sensor showing auto-update scheduler state, cron expression, and next run times
- Update history — sensor tracking the most recent stack update with result details
- Multi-agent support — works with multiple Dockge agents, each with their own device hierarchy
This integration requires a Dockge instance with the REST API enabled. You will need:
- A running Dockge instance (fork with REST API and update management)
- An API key configured in Dockge
- Open HACS in your Home Assistant instance
- Click the three dots in the top right and select Custom repositories
- Add
https://github.com/finder39/ha-dockgewith category Integration - Click Download on the Dockge card
- Restart Home Assistant
Or click the button above to add the repository directly.
- Copy the
custom_components/dockge/directory to your Home Assistantcustom_components/folder - Restart Home Assistant
- Go to Settings > Devices & Services > Add Integration
- Search for Dockge
- Enter your Dockge URL (e.g.,
http://192.168.1.100:5001) - Enter your API key
- Optionally adjust the scan interval (default: 300 seconds)
| Type | Entity | Description |
|---|---|---|
| Sensor | Image Updates Available | Count of stacks with available updates |
| Sensor | Server Summary | Running container count with per-stack breakdown in attributes |
| Sensor | Auto-Update Scheduler | Scheduler status with cron details (primary agent only) |
| Sensor | Last Stack Update | Timestamp of most recent update (primary agent only) |
| Sensor | Next Auto Update | Next scheduled auto-update time (primary agent only) |
| Sensor | Next Image Check | Next scheduled image check time (primary agent only) |
| Sensor | Global Summary | Aggregate across all agents (multi-agent only, on primary device) |
| Type | Entity | Description |
|---|---|---|
| Binary Sensor | Update Available | On when stack has image updates |
| Binary Sensor | {container} Update Available | On when a specific container has updates |
| Sensor | {container} | Container state with image and health attributes |
| Button | Update | Pull latest images and recreate the stack |
| Button | Check Updates | Check for new image updates |
| Switch | Auto Update | Enable/disable auto-updates for this stack |
All services are available under the dockge domain (e.g., dockge.start_stack). The optional agent field accepts an agent display name (e.g., "Gastly") for multi-agent setups; leave empty for the primary server.
| Service | Fields | Description |
|---|---|---|
start_stack |
stack_name, agent? |
Start a Docker Compose stack |
stop_stack |
stack_name, agent? |
Stop a Docker Compose stack |
restart_stack |
stack_name, agent? |
Restart a Docker Compose stack |
update_stack |
stack_name, agent? |
Pull latest images and recreate a stack |
check_updates |
stack_name, agent? |
Check for image updates on a stack |
update_all |
agent? |
Update all stacks (optionally on a specific agent) |
trigger_auto_updates |
(none) | Trigger auto-updates on all stacks with auto-update enabled |
system_prune |
agent? |
Run Docker system prune to clean up unused images, containers, and networks |
For a visual dashboard, check out the Dockge Card — a custom Lovelace card that auto-discovers your servers and stacks with real-time status, actions, and processing indicators.
This integration was built entirely through vibe coding with Claude Code.
MIT