Home Assistant: Difference between revisions

From KG7QIN's Wiki
Jump to navigation Jump to search
(Created initial page)
 
(Added HACS integration and and cleaned up entry)
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[Category:Home Automation]]
Information on setting up a Dockerized version of Home Assistant with the Z-Wave JS UI:
Information on setting up a Dockerized version of Home Assistant with the Z-Wave JS UI:


Line 32: Line 33:
       # Do not use /dev/ttyUSBX serial devices, as those mappings can change over time.
       # 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.
       # Instead, use the /dev/serial/by-id/X serial device for your Z-Wave stick.
       - '/dev/serial/by-id/usb-Zooz_800_Z-Wave_Stick_533D004242-if00:/dev/zwave'
       - '/dev/serial/by-id/<device-id>:/dev/zwave'
     volumes:
     volumes:
       - ./zwave-config:/usr/src/app/store
       - ./zwave-config:/usr/src/app/store
Line 40: Line 41:
#      - '3000:3000' # port for Z-Wave JS websocket server
#      - '3000:3000' # port for Z-Wave JS websocket server
</syntaxhighlight>
</syntaxhighlight>
==Install HACS==
To install HACS<ref>https://hacs.xyz/</ref> in the Home Assistant Docker container:
# SSH into system
# Navigate to directory with docker-compose.yml file in it
# Enter container's shell with: <syntaxhighlight lang="bash">docker-compose exec homeassistant bash</syntaxhighlight>
# Run the HACS install script<ref>https://hacs.xyz/docs/setup/download</ref> with: <syntaxhighlight lang="bash">wget -O - https://get.hacs.xyz | bash -</syntaxhighlight>
# Exit the container's shell
# Restart the containers with: <syntaxhighlight lang="bash">docker-compose restart</syntaxhighlight>
# Follow the instructions at [https://hacs.xyz/docs/configuration/basic Configuration]<ref>https://hacs.xyz/docs/configuration/basic</ref> to setup HACS integration
=References=

Latest revision as of 03:12, 12 April 2024

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