🧰 Manual for Testers: Setting Up Z-Wave JS UI in Home Assistant

Z-Wave JS UI is a powerful Z-Wave Home Assistant integration with a full web interface for network management. It's ideal for advanced users who want full control.

Purposes of each component:

• Z-Wave JS UI addon - this addon manages Z-Wave network from Home Assisntant.
• Z-Wave Integration - Z-Wave device management app. It uses add-on as intermediary part for communication between Home Assistant and Z-Wave devices.

1️⃣ Install the Z-Wave JS UI Add-on

📦 Step 1: Add the Add-on Repository

1. Go to Settings → Add-ons in Home Assistant.

2. Click “Add-on Store”.

3. Click the menu (⋮) in the top right → Repositories.

4. Paste the repository URL: https://github.com/hassio-addons/addon-zwave-js-ui

5. Click Add, then close the dialog.

🧪 Step 2: Install Z-Wave JS UI

1. Locate Z-Wave JS UI in the Add-on Store.
2. Click it → Press Install.
3. Wait for installation to complete.
   

    

   

   
   

2️⃣ Configure the Add-on

🛠️ Step 3: Basic Settings

• Enable (optional) Start on boot
• Enable (optional) Watchdog
• Enable Show on sidebar
• Click Start

• 

🔌 Step 4: Set the Serial Port and Z-Wave settings

1. After Starting, open Z-Wave JS tab in the left menu.
2. Click on Setting button.
3. Go to Z-Wave list of setting, Enable, enter Seiral port based on template tcp://IP-ADDRESS:port, generate keys and click Save.
   

   

   
   
4. Go to Z-Wave JS UI dashboard and check that Z-Wave controller was activated.