Home Assistant

From KG7QIN's Wiki
Jump to navigation Jump to search

Information on setting up a Dockerized version of Home Assistant with the Z-Wave JS UI:

Setup

docker-compose.yml

version: '3'
services:
  homeassistant:
    container_name: homeassistant
    image: "ghcr.io/home-assistant/home-assistant:stable"
    volumes:
      - ./config:/config
      - /etc/localtime:/etc/localtime:ro
      - /run/dbus:/run/dbus:ro
    restart: unless-stopped
    privileged: true
    network_mode: host
  zwave-js-ui:
    container_name: zwave-js-ui
    image: zwavejs/zwave-js-ui:latest
    restart: unless-stopped
    tty: true
    stop_signal: SIGINT
    environment:
      - SESSION_SECRET=mysuperawesomesecret
      - ZWAVEJS_EXTERNAL_CONFIG=/usr/src/app/store/.config-db
      # Uncomment if you want logs time and dates to match your timezone instead of UTC
      # Available at https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
      - TZ=America/Los_Angeles
    network_mode: host
    devices:
      # Do not use /dev/ttyUSBX serial devices, as those mappings can change over time.
      # Instead, use the /dev/serial/by-id/X serial device for your Z-Wave stick.
      - '/dev/serial/by-id/<device-id>:/dev/zwave'
    volumes:
      - ./zwave-config:/usr/src/app/store
# ports aren't used in host network mode
#    ports:
#      - '8091:8091' # port for web interface
#      - '3000:3000' # port for Z-Wave JS websocket server

Install HACS

To install HACS[1] in the Home Assistant Docker container:

  1. SSH into system
  2. Navigate to directory with docker-compose.yml file in it
  3. Enter container's shell with:
    docker-compose exec homeassistant bash
    
  4. Run the HACS install script[2] with:
    wget -O - https://get.hacs.xyz | bash -
    
  5. Exit the container's shell
  6. Restart the containers with:
    docker-compose restart
    
  7. Follow the instructions at Configuration[3] to setup HACS integration

References