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