Skip to content

3.1

Choose a tag to compare

View all tags
@johro897 johro897 released this 10 May 18:14
3.1
1dc7012
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

v3.1

Pause / Resume support

Containers can now be paused and resumed directly from the card — no extra helpers or scripts required.

This release is timed to align with Home Assistant 2026.5, which brought a significant expansion to the [Portainer integration](https://www.home-assistant.io/integrations/portainer/). Among the new additions are dedicated button.*_pause_container and button.*_resume_container entities per container, meaning pause and resume work out of the box if you're on HA 2026.5 or newer with the Portainer integration installed.

What's new

Per-container pause / resume

  • A Pause button appears next to Restart for every running container that has pause_entity configured
  • When paused, the button changes to Resume and the row border and status text switch to amber
  • The toggle switch is automatically disabled while a container is paused — start/stop is not available in that state
  • The Pause / Resume button is hidden entirely for stopped containers

Overview breakdown

The running tile in the overview now supports a full running · paused · stopped display when containers_paused and/or containers_stopped sensors are configured in docker_overview. Without those sensors it falls back to the previous running / total format — no configuration change required.

New config keys

Key Scope Description
pause_entity Container Button/script/automation to press when pausing
resume_entity Container Button/script/automation to press when resuming
paused_states Card / Container List of states that count as paused (default: ["paused", "pause"])
paused_color Card / Container Accent color for paused containers (default: #f4b942)
containers_paused docker_overview Sensor for number of paused containers — enables the running · paused · stopped breakdown in the overview tile

Minimal config example (HA 2026.5 + Portainer)

containers:
  - name: Uptime Kuma
    status_entity: sensor.uptime_kuma_state
    control_entity: switch.uptime_kuma_container
    pause_entity: button.uptime_kuma_pause_container
    resume_entity: button.uptime_kuma_resume_container
    restart_entity: button.uptime_kuma_restart_container

Note: Use a sensor (not binary_sensor) for status_entity. A binary sensor only reports on/off and cannot represent a paused state.

Bug fixes

  • Fixed containers_running in overview tile incorrectly showing the stopped count when both keys pointed to the same entity — the label and value are now independent
  • Fixed the overview running tile using raw entity value instead of parsed integer when computing the not-running color class

Compatibility

Requirement Version
Home Assistant 2025.8 or newer
Portainer integration (for pause/resume) 2026.5 or newer
WUD Monitor (for update tracking) Any
Assets 2
Loading