This article describes the setup of the Z-Stick 7 in Home Assistant using ZWaveJS to MQTT; it forms part of the larger Z-Stick 7 user guide. Setting up Home Assistant with Z-Stick 7 lets you build a Z-Wave automation network utilising Z-Wave 700 series and Gen7 technologies. 


Requirements. 

Hardware Recommendations.

  • Raspberry Pi 3 or later
  • microSD card (at least 32GB and class 2; recommended 128GB SanDisk MAX Endurance for future proof or camera recordings)


If using Windows, follow the steps here to get a Virtual Machine running Home Assistant OS: Setup Home Assistant in Windows


If you're installing Z-Wave JS to MQTT on a fresh installation. 


These steps assume that you have a fresh install of Home Assistant and have not yet installed Z-WaveJS UI. Make sure to delete ZWaveJS integration and follow the steps below. 


If you have a fresh install, you may follow the steps below to fully install Z-Wave JS UI. 


1. Gain access to the community repository first.

  2. Click Setting
  3. Click Add-on -> ADD-ON STORE (button at bottom right)
  4. Click top right icon (vertical 3 dot icon)
  5. Select Repositories
  6. Input: 
  7. Then click ADD


2. Install and use Z-WaveJS UI
  2. Click Setting -> Add-on
  3. Search for "ZWave"
  4. Click Z-Wave JS UI
  5. Click Install, then wait about 2 to 3 minutes for the installation to complete
  6. Click Start, takes about 24 seconds.
  7. Wait 1 minute for HASS to boot up Z-Wave JS UI
  8. Click "Open Web UI"
  9. Click Menu (hamburger icon) -> Settings

  10. Click Zwave
  11. Click Serial port and select /dev/ttyUSB0
  12. Next to Network Key, click the refresh button to add a random security key for S0 Legacy, S2 Authenticated, S2 Unauthenticated, and S2 Access control.

    image 1 - randomize key buttons.

    image 2 - randomized network keys generated.

  13. Click Save
  14. Click 4 box icon (Control Panel), and see if the driver boots up properly. If it does, the controller will appear as the first device. 
  15. Click Settings -> Devices & Services

  16. Click + Add Integrations
  17. Search ZWave
  18. Click Z-Wave
  19. Uncheck "Use the Z-Wave JS Supervisor add-on"
  20. Click Submit
  21. Copy and Paste "ws://a0d7b954-zwavejs2mqtt:3000"
  22. Click Submit
  23. Set your devices to the areas they are installed in, then click Finish


Pairing your first Z-Wave device.


1. Open the Z-WaveJS UI interface
2. Click on 3 line bubble at the bottom right -> Infinity Green Icon ("Manage Nodes") -> Inclusion + NEXT -> NEXT -> NEXT 


3. Your Z-Stick 7 should now be in pair mode to pair Z-Wave devices. Refer to the Z-Wave devices instruction manual on its button press combination to pair it. (Typically its 1 tap to the z-wave device buttons, but different devices may have different combos of button presses to pair them).