docker-compose.yml

version: "3.9"

# Local development compose file.
#
# Starts a single Home Assistant instance wired up exactly as the test
# container does it, but without the Python/pytest wrapper — useful for
# exploring the UI, building UIX dashboards, or manual verification.
#
# Usage:
#   make setup              # download UIX into custom_components/
#   docker compose up       # start HA
#   open http://localhost:8123

services:
  homeassistant:
    image: ghcr.io/home-assistant/home-assistant:${HA_VERSION:-stable}
    container_name: ha-testcontainer-dev
    restart: unless-stopped
    environment:
      - TZ=UTC
    volumes:
      # Mount the demo config as /config.
      - ./ha-config:/config:rw
      # Mount custom components (populated by `make setup`) alongside the
      # config so HA picks them up automatically.
      - ./custom_components:/config/custom_components:rw
    ports:
      - "8123:8123"
    healthcheck:
      test: ["CMD", "curl", "-sf", "http://localhost:8123/api/"]
      interval: 30s
      timeout: 10s
      retries: 10
      start_period: 60s