> For the complete documentation index, see [llms.txt](https://kb.linknlink.com/isg/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.linknlink.com/isg/using-isg/add-ons/isg-required-add-ons/z-wave-js-ul.md).

# 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>