docker-compose/homeassistant/docker-compose.yml

# Home Assistant Smart Home Platform Configuration
services:
  homeassistant:
    # Basic container configuration
    container_name: homeassistant
    image: docker.io/homeassistant/home-assistant:2025.7.2  # Official Home Assistant image
    restart: unless-stopped  # Auto-restart on failure

    # Network configuration (host mode for full local network access)
    network_mode: host  # Required for discovering local devices and integrations
    
    # Persistent storage and system configuration
    volumes:
      - ${APPDATA_PATH}/homeassistant/config:/config  # Configuration files
      - /etc/localtime:/etc/localtime:ro  # Sync host timezone for proper logging

    # Health check configuration
    healthcheck:
      test: "curl --connect-timeout 10 --silent -f http://127.0.0.1:8123/ || exit 1"
      interval: 45s
      timeout: 30s
      retries: 3