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.1
    restart: unless-stopped
    
    # Persistent storage and system configuration
    volumes:
      - ${APPDATA_PATH}/homeassistant/config:/config  # Configuration files
      - /etc/localtime:/etc/localtime:ro  # Sync host timezone
    
    # Network port configuration
    ports:
      - ${PORT}:8123  # Web interface port
    
    # Network configuration
    networks:
      - frontend  # Connects to frontend network

# External network definition
networks:
  frontend:
    external: true  # Uses pre-existing frontend network