# 🧰 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.  
    [![image.png](https://smlight.tech/support/manuals/uploads/images/gallery/2026-07/scaled-1680-/Yqsimage.png)](https://smlight.tech/support/manuals/uploads/images/gallery/2026-07/Yqsimage.png)

### 2️⃣ Configure the Add-on

#### 🛠️ Step 3: Basic Settings

- Enable (optional) **Start on boot**
- Enable (optional) **Watchdog**
- Enable **Show on sidebar**
- Click `Start`
- [![image.png](https://smlight.tech/support/manuals/uploads/images/gallery/2026-07/scaled-1680-/ujXimage.png)](https://smlight.tech/support/manuals/uploads/images/gallery/2026-07/ujXimage.png)

#### 🔌 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.  
    [![image.png](https://smlight.tech/support/manuals/uploads/images/gallery/2026-07/scaled-1680-/Q3pimage.png)](https://smlight.tech/support/manuals/uploads/images/gallery/2026-07/Q3pimage.png)
4. Go to Z-Wave JS UI dashboard and check that Z-Wave controller was activated.  
    [![image.png](https://smlight.tech/support/manuals/uploads/images/gallery/2026-07/scaled-1680-/GP6image.png)](https://smlight.tech/support/manuals/uploads/images/gallery/2026-07/GP6image.png)