In our guide to the best Z-Wave add-on for Home Assistant, Z-Wave JS vs ZwaveJS2MQTT, we concluded that ZwaveJS2MQTT is presently your best choice. There are still users who prefer the simplicity and 'officialness' of Z-Wave JS though. If you're one of them, this setup guide is for you.

If you'd prefer to setup Z-Wave Plus 800 series with ZwaveJS2MQTT, follow that link to a dedicated guide.

The following steps assume that it's a fresh installation of Home Assistant to which you're adding Z-Wave. If you haven't already setup Home Assistant with a Raspberry Pi, follow that link to our dedicated guide.

1. Open Home Assistant in a browser, usually at http://homeassistant.local:8123/
2. Click "Configuration".
3. Click "Add-ons, Backups & Supervisor".
4. Seach for 'Z-Wave JS'. Click on the appropriate result and then click Install.
5. Once installed, navigate to the "Configuration" tab.
6. From the list of devices, select Atrim Stick.
7. Leave the authentication key fields blank; they will be generated automatically when you start the Z-Wave add-on.
8. Click "Save".
9. Navigate to the "Info" tab.
10. Activate "Start on boot".
11. Activate "Watchdog"; should Home Assistant or the add-on crash, watchdog will automatically restart Z-Wave JS.
12. Click "Start".
13. Verify that your security keys have been automatically generated:
    1. Navigate to the "Configuration" tab.
    2. Various fields, such as "network_key" and "s2_authenticated_key" should now have values. If they do not, hard refresh the browser page and navigate back to "Configuration".
    3. Should the fields still be blank, restart your Home Assistant installation and navigate back to "Configuration".
    4. Should the fields still be blank, manually enter the key information in the appropriate format.
14. Reboot your Home Assistant so that all changes made by Z-Wave JS are applied and enabled.

Now that you have added Z-Wave JS to Home Assistant, it's time to configure it so that you can add devices to your automation system.

1. Open Home Assistant in a browser, usually at http://homeassistant.local:8123/
2. Click "Configuration".
3. Click "Devices & Services".
4. Navigate to the "Integrations" tab.
5. Click "Configure" under "Z-Wave JS".
6. If prompted, click “Submit” to begin the configuration.
7. Under "Area", select the room in which Atrim Stick is installed (e.g. hallway).
8. Click "Finish".
9. Z-Wave JS should no longer be highlighted as "Discovered".

Installing Z-Wave devices with Z-Wave JS

Now that you have Home Assistant, Z-Wave JS, and 800 series Z-Wave Plus running, it's time to connect Z-Wave devices to Home Assistant. While Atrim Stick is powered by 800 series devices, it's also compatible with older devices using everything from 100 series Z-Wave right through to 700 series / Gen7.

To install / pair Z-Wave devices with Z-Wave JS:

1. Within Home Assistant, click "Configuration".
2. Click "Devices & Services".
3. Under "Z-Wave JS" click "Configure".
4. Click "Add Device".
5. Follow the on-screen prompts to add your Z-Wave device via SmartStart or via standard inclusion. The user manual that came with your product will help with standard inclusion.