Support

Table of contents

How to add Z-Wave devices to Home Assistant Green

This guide walks you through adding Z-Wave devices to Home Assistant Green using the Home Assistant ZWA-2.

What you need…

1: Set up Z-Wave in Home Assistant

If you haven’t set up the Z-Wave integration in Home Assistant yet:

    1. Go to Settings > Devices & services
    2. Click Add integration
    3. Search Z-Wave
    4. Choose Z-Wave JS
    5. When it asks for the device/serial path, select the ZWA-2 (it often auto-detects)
    6. Finish the setup

After this, you’ll see Z-Wave JS in your integrations list.

2: Open the Z-Wave control panel

This is where you do inclusions (adding), exclusions (removing), and troubleshooting.

    1. Go to Settings > Devices & services
    2. Click Z-Wave JS
    3. Click Configure
    4. Open Z-Wave JS UI (or the “Open” button if it’s shown)

3: Put Home Assistant into Z-Wave pairing mode

Start Z-Wave inclusion in Home Assistant…

    1. In Z-Wave JS UI, choose Add Node (or Inclusion)
    2. Pick the inclusion type (if asked):
      • S2 (best security) for locks and modern devices
      • S0 (older security) if the device only supports S0
      • Unsecure (sometimes best for simple sensors/switches if security causes issues)

4: Put your Z-Wave device into pairing mode

This step depends on the device type and manufacturer (please consult the manual for your device if required). Here are the most common methods to place a Z-Wave device into pairing mode:

    1. Tap the device button once (or sometimes 3 times quickly)
    2. Or hold the pairing button for a few seconds
    3. Some in-wall lighting devices can be placed into pairing mode via activating the attached switch multiple times
    4. Shelly Wave devices rely on pressing the button in a certain sequence.

5: Name the device and assign it to a room

Once added:

    1. Go to Settings > Devices & services > Devices
    2. Find the new Z-Wave device
    3. Rename it (example: Front Door Sensor)
    4. Set an Area (example: Entry)

Now you can use it in Automations, Dashboards, and Scenes.

If asked for for a PIN / DSK (S2)

Some S2 (secure) devices require a code to complete pairing. You may need to enter the DSK (often a 5-digit PIN, or the first 5 digits of the DSK) found on:

    • a sticker on the device
    • the manual
    • a QR code label

Home Assistant will prompt you if it needs it.

Fixes if pairing doesn’t work

If your Z-Wave device will not successfully pair, try these troubleshooting tips…

Try in this order:

    • Exclude it first, then include again
    • Bring it closer to the ZWA-2 for pairing
    • Try a different inclusion type (S2 > S0 > Unsecure)
    • Power-cycle the device (or remove battery and reinsert)
    • Restart Home Assistant (Settings > System > Restart)
Updated on February 19, 2026