v1.0.0

Initial Release

A simple, theme-aware Lovelace card for monitoring and controlling Docker containers directly from Home Assistant.

Features

• Docker Overview Panel

  • Compact tiles showing running/total containers, image count, Docker version, and OS information
  • Clickable overview tiles that open entity details on tap
  • Visual indicator when running container count differs from total

• Container Management

  • Live status display for each container with color-coded states
  • Toggle containers on/off with integrated switch controls
  • Quick restart functionality per container
  • Collapsible container list (collapsed by default) with user-configurable containers_expanded option
  • Container names automatically truncate with ellipsis on small screens to keep controls visible

• Resource Monitoring

  • Per-container CPU and memory usage visualization
  • Minimalist progress bars at the bottom of each container card
  • Color-coded indicators: green (<50%), yellow (50-80%), red (>80%)
  • Optional cpu_entity and memory_entity configuration per container

• Customization

  • Global and per-container running_color and not_running_color overrides
  • Configurable running_states and stopped_states for custom container state interpretation
  • Support for custom tap_action and hold_action on container rows
  • Theme-aware styling that inherits Home Assistant colors and spacing

• Entity Support

  • Works out-of-the-box with Home Assistant Portainer integration entities
  • Supports any toggle-friendly domain: switch, input_boolean, light, etc.
  • Compatible with custom service calls for start/stop/restart operations
  • Legacy switch_entity and stopped_color configuration options for backward compatibility

Requirements

• Home Assistant 2025.8 or newer
• Entities exposing Docker container data (e.g., Portainer integration, command_line sensors, or equivalent)

Installation

Via HACS (recommended) or manual installation. See README.md for detailed setup instructions.

Configuration

Minimal example:

type: custom:docker-card
title: Docker
containers:
  - name: Home Assistant
    status_entity: sensor.docker_homeassistant_status
    control_entity: switch.docker_homeassistant
    restart_entity: button.docker_restart_homeassistant
    cpu_entity: sensor.docker_homeassistant_cpu
    memory_entity: sensor.docker_homeassistant_memory

Full configuration options and examples available in the README.

For issues, feature requests, or contributions, visit the GitHub repository.