Z-Wave Protocol Setup

Use this guide when your setup includes Z-Wave devices such as locks, switches, sensors, dimmers, or other residential automation hardware.

Before You Start

Confirm the following before setting up Z-Wave:

1. Your Home Assistant system is installed and running.
2. A supported Z-Wave controller is available.
3. You have a USB extension cable (at least 1 meter recommended to avoid USB 3.0 interference).

Supported Controllers

• Home Assistant Connect ZWA-2
• Aeotec Z-Stick Gen5+
• Zooz ZST39 LR (supports Z-Wave Long Range)
• Silicon Labs UZB-7
• Other 700- or 800-series Z-Wave controllers

Step 1: Connect the Controller

1. Connect the Z-Wave controller to your SeloraBox PC using a USB extension cable.
2. Go to Settings → System → Hardware and confirm the controller is detected.

Step 2: Set Up the Z-Wave Integration

1. In Home Assistant, go to Settings → Devices & Services.
2. If the controller has been auto-discovered, it will appear at the top under Discovered. Select it and add the Z-Wave integration.
3. If it has not been discovered, select + Add Integration and search for Z-Wave.
4. Home Assistant will install and start the Z-Wave JS add-on automatically. Wait for it to finish.
5. Confirm the controller is detected correctly and the Z-Wave network shows as ready.

Step 3: Access the Z-Wave JS UI

The Z-Wave JS UI provides detailed network management beyond what the Home Assistant Z-Wave integration page shows.

1. Go to Settings → Add-ons → Z-Wave JS UI.
2. Enable Show in sidebar for quick access.
3. Open the UI and confirm the controller firmware version and network status are displayed.

Next Step

Once the controller is connected and the Z-Wave JS integration is running, you are ready to include Z-Wave devices.

Pairing Z-Wave Devices →