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


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.

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

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

  9. Click Zwave
  10. Click Serial port and select /dev/ttyUSB0
  11. 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.

  12. Click Save
  13. 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. 
  14. Click Settings -> Devices & Services

  15. Click + Add Integrations
  16. Search ZWave
  17. Click Z-Wave JS
  18. Uncheck "Use the Z-Wave JS Supervisor add-on"
  19. Click Submit
  20. Copy and Paste "ws://a0d7b954-zwavejs2mqtt:3000"
  21. Click Submit
  22. 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).