current_patch_version: 2

date_released: 2025-08-15

"textlint": "^15.2.1",

"textlint-rule-terminology": "^5.2.14"

&[rel*="external"] {

white-space: nowrap;

You need to have a compatible Z-Wave adapter installed. The following devices have been confirmed to work with Z-Wave JS:

The firmwares of 700 and 800 series Z-Wave adapters have several bugs which impact the stability of the mesh and can cause the adapter to become unresponsive. Because there is no known firmware version that is completely fixed, it is recommended to choose a firmware based on the following criteria:

- 700 series:

- prefer SDK versions 7.17.2 to 7.18.x or 7.21.6 and newer

- SDK versions 7.19.x are okay

- avoid SDK versions before 7.17.2

- avoid SDK versions 7.20 to 7.21.5

- 800 series

- prefer SDK versions 7.23.x and newer

- SDK versions 7.22.x are okay

- SDK versions 7.17.2 to 7.19.x are okay

- avoid SDK versions before 7.17.2

- avoid SDK versions 7.20 to 7.21.3

{% note %}

The SDK version does not have to match the firmware version. If you are unsure which SDK versions a firmware is based on, contact the manufacturer of your device.

{% endnote %}

{% important %}

You should upgrade the firmware on all 700 and 800 series adapters to a recommended version.

{% endimportant %}

Firmware can be upgraded using the below directions:

- [Upgrade instructions using Linux](https://github.com/kpine/zwave-js-server-docker/wiki/700-series-Controller-Firmware-Updates-(Linux))

- [Upgrade instructions using Windows (Aeotec)](https://aeotec.freshdesk.com/support/solutions/articles/6000252296-update-z-stick-7-with-windows)

- [Upgrade instructions using Windows (Zooz)](https://www.support.getzooz.com/kb/article/931-how-to-perform-an-ota-firmware-update-on-your-zst10-700-z-wave-stick/)

- [Upgrade instructions using Windows/Linux (Z-Wave.Me)](https://z-wave.me/support/uzbrazberry-firmwares/)

{% endwarning %}

- 800 series USB adapters (with some caveats, see notes)

- [Home Assistant Connect ZWA-2](/connect/zwa-2/)

- HomeSeer SmartStick G8

- Zooz 800 Series Z-Wave Long Range S2 Stick (ZST39 LR)

- 700 series USB adapters

- Aeotec Z-Stick 7 USB stick (ZWA010) (the EU version is not recommended due to RF performance issues)

- HomeSeer SmartStick+ G3

- HomeSeer Z-NET G3

- Silicon Labs UZB-7 USB Stick (Silabs SLUSB7000A / SLUSB001A)

- Zooz S2 Stick 700 (ZST10 700)

- Z-Wave.Me Z-Station

- 500 series USB adapters

- Aeotec Z-Stick Gen5 (see note below)

- Everspring USB stick - Gen 5

- GoControl HUSBZB-1 stick

- Sigma Designs UZB stick

- Vision USB stick - Gen5

- Z-Wave.Me UZB1 stick (see Aeotec Z-Stick note below)

- HomeSeer SmartStick+ G2

- HomeSeer Z-NET G2

- Raspberry Pi HAT adapters

- Aeotec Z-Pi 7 Raspberry Pi HAT/Shield (ZWA025, 700 series)

- Z-Wave.Me RaZberry 7 (ZME_RAZBERRY7, 700 series)

- Z-Wave.Me RaZberry 7 Pro (ZMEERAZBERRY7_PRO or ZMEURAZBERRY7_PRO, 700 series)

- Z-Wave.Me Razberry 2 (500 series)

- Z-Wave.Me Razberry 1 (300 series)

If you are just starting out, we recommend that you purchase an 800 series adapter (with firmware updated to ≥ 7.23.2). The 800 series adapters are the most future-proof and offer the best RF performance.

{% tip %}

It's recommended to use a USB stick, not a module. Passing a module through Docker is more complicated than passing a USB stick through.

{% endtip %}

For the best experience, it is recommended to use an adapter directly with Home Assistant. If this doesn't work for you, you can use a hub that supports Z-Wave. Home Assistant supports the following third-party hubs with Z-Wave support:

- [Vera](/integrations/vera/)

- [Fibaro](/integrations/fibaro/)

- [SmartThings](/integrations/smartthings/)

- [Z-Wave.Me Z-Way](/integrations/zwave_me)

{% note %}

The Aeotec Z-Stick and some of its variants (e.g. Z-Wave.Me UZB1) are known to have compatibility issues with the Linux kernel because of their [non-compliant behavior](https://forums.raspberrypi.com/viewtopic.php?f=28&t=245031#p1502030). Plugging these adapters through a USB hub can serve as a workaround that sometimes mitigates the issue.

It's totally normal for your Z-Wave stick to cycle through its LEDs (Yellow, Blue and Red) while plugged into your system.

On Raspberry Pi 3 and 4, you need to disable the on-board Bluetooth since the board requires the use of the hardware UART (whose pins are shared with the Bluetooth). You do this by adjusting the `/boot/config.txt`.

For both processes below you will need to insert your SD card into your PC and open the configuration file with your favorite text editor.

- Once you mounted the disk, you will see the `config.txt` directly in the root directory.

Add the following parameters to the bottom of the `config.txt` file.

Add the following parameters to the bottom of the `/boot/config.txt` file.

For Home Assistant OS this should be everything you need to do. You should now be able to use Razberry Z-Wave from `/dev/ttyAMA0`.

For other operating systems such as Raspberry Pi OS you will also have to run the following command:

sudo systemctl disable hciuart

It is possible to keep a limited Bluetooth functionality while using Razberry Z-Wave. Check `boot/overlays/README` on `miniuart-bt`.

{% endnote %}

{% note %}

`disable-bt` was previously known as `pi3-disable-bt`. If your OS is old, you might need to use this instead.

{% endnote %}

{% note %}

If you've installed the Z-Wave.Me Z-Way software. In order to use Z-Wave JS instead of Z-Way, you'll need to ensure you disable it before you install Home Assistant, or you won't be able to access the board. Do this with `sudo /etc/init.d/z-way-server stop; sudo update-rc.d z-way-server disable`. Alternatively, you could use the [Z-Wave.Me](/integrations/zwave_me) integration.

2. in Step 4, you will be prompted to choose a **Device path**. Choose **ttyAMA0**.

AirGradient creates indoor and outdoor air quality monitors that enable you know if the air quality is healthy or not. They measure metrics such as PM2.5, CO2, TVOCs, and NOx. Both the software and hardware are open-source, allowing you to customize or extend the device functionality.

- AirGradient DIY Air Quality Monitor

- AirGradient Indoor Air Quality Monitor

- AirGradient Outdoor Air Quality Monitor

The Home Assistant Cloud allows you to quickly integrate your local Home Assistant with various cloud services like Amazon Alexa and Google Assistant. It also enables a secure remote connection, speech-to-text, text-to-speech, an offsite backup location, Webhooks support, and better WebRTC. [Learn more.](/cloud)