# Z-Wave JS Ul

## Prerequisite:

1. The iSG system version must be 20124 or higher.
2. You can refer to this guide for upgrading the iSG version: [iSG firmware Updates](https://kb.linknlink.com/isg/settings/firmware-updates/isg-software).
3. You need to have a Z-Wave USB dongle.
4. Use the [Serial Port Viewer](https://kb.linknlink.com/isg/using-isg/add-ons/serial-port-viewer) Add-on to view the serial port information of the Z-wave USB dongle in the system and copy its Path information.

## Instructions for Use:

**1）**Turn on the iSG, and in the left navigation bar of the iSG, find "Add-Ons" → "ZWave-JS-Ul". Then click on "Install".

<figure><img src="/files/zIKUSPY7kIVwoH5LjQGy" alt=""><figcaption></figcaption></figure>

**2）**&#x41;fter the installation is successful, the service is default to being disabled. If you need to enable it, click on "Enable".

<figure><img src="/files/IGCUan9EaL59yI1mqYcB" alt=""><figcaption></figcaption></figure>

Turn on Auto Start Service. The plug-in service will be automatically started every time iSG restarts.

<figure><img src="/files/5cXTaRBUrAZlZ8gd4Fqa" alt=""><figcaption></figcaption></figure>

3）Access iSG ZWave-JS UI webpage in PC web browser by using URL shows on Add-on.&#x20;

<figure><img src="/files/H66NKLeAW0uL9zlHjaxG" alt=""><figcaption></figcaption></figure>

Go to Settings - Z-wave, input the Serial Port Path copied from Serial Port Viewer add-on, and click flash button to generate all keys, then click SAVE

<figure><img src="/files/5QEQ8NJuCQOhqH3jQo06" alt=""><figcaption></figcaption></figure>

4\) Go to Control Panel, you should be able to see the Z-wave dongle you have added. Click the dongle infomation section to see the detail&#x20;

<figure><img src="/files/9KKZVnRV6uyEcKNqG9KZ" alt=""><figcaption></figcaption></figure>

5\) Add Z-wave device in webpage, click right bottom manue and click manage nodes

<figure><img src="/files/uDO0qiNjiAPrdPkqQpqp" alt=""><figcaption></figcaption></figure>

6\) Add to Home Assistant, Go to Settings - Home Assistant, enable WS Server and keep the Serier Port 3000.

<figure><img src="/files/UYHVejkm2ybB5EesGKc4" alt=""><figcaption></figcaption></figure>

7\) Login to iSG built in Home Assistant, Go to Settings - Device & Services - ADD Integration, search Z-wave, Click Z-wave.

<figure><img src="/files/OfjAonN0cXkPzKbWbIax" alt=""><figcaption></figcaption></figure>

Input URL, ws\://127.0.0.1:3000, then submit

<figure><img src="/files/DiRA7MbQeT8BiR1vSYvB" alt=""><figcaption></figcaption></figure>

8\) You can now see the Z-wave intergration in the list

<figure><img src="/files/25GQ1EhJyHGxqvI1V0sp" alt=""><figcaption></figcaption></figure>

9\) Click Configure to add Z-wave devices

<figure><img src="/files/3gYp4t6OE9WgHNh8fpnm" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/wiD2kj0aBgOtd1AyAhWN" alt=""><figcaption></figcaption></figure>

10\) Add Z-wace JS to Home Assistant Side bar, Click Settings - Dashboards - Add Dashboard, Input Title and choose the icon, then Creat dashboard.

<figure><img src="/files/aFLazvPD7Xd2ah7ngH0l" alt=""><figcaption></figcaption></figure>

Go to Side Bar, Choose Z-wave JS, click add card, choose Webpage

<figure><img src="/files/QjVEt23AfnbjQ93o9LYg" alt=""><figcaption></figcaption></figure>

Input URL, <http://Your> iSG IP:8091, sand Save

<figure><img src="/files/CwfQ9u7u9e0FlVRN3XJO" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/U1Dhv2pzBL4GKeHFtlzM" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.linknlink.com/isg/using-isg/add-ons/isg-required-add-ons/z-wave-js-ul.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.