This integration allows you to control a Z-Wave network via the Z-Wave.Me Z-Way. It combines the performance and the power of the diagnostics tools built-in Z-Way with the flexibility of Home Assistant. The integration brings all Z-Way devices in Home Assistant (Z-Wave, EnOcean, HTTP based, and others).


Adding Z-Wave.Me to your Home Assistant instance can be done via the user interface, by using this My button:

Z-Wave.Me can be auto-discovered by Home Assistant. If an instance was found, it will be shown as “Discovered”, which you can select to set it up right away.

Manual configuration steps

The IP address with the port of the Z-Way server. The IP address can be prefixed with wss:// if HTTPS should be used instead of HTTP (when using find.z-wave.me remote access service or public IP with SSL).

API Token

Z-Way API access token of the Z-Way server. To get the token go to the Z-Way user interface Smart Home UI > Menu > Settings > Users > Administrator > API token.

When connecting via find.z-wave.me remote access service you need to use a token with a global scope (log-in to Z-Way via find.z-wave.me for this).

Example of connecting to Z-Way in the local network:

  • URL:
  • API Token: /112f7a4a-0051-cc2b-3b61-1898181b9950

Example of connecting to Z-Way via remote access find.z-wave.me:

  • URL: wss://find.z-wave.me
  • API Token: 0481effe8a5c6f757b455babb678dc0e764feae279/112f7a4a-0051-cc2b-3b61-1898181b9950

Example of connecting to Z-Way with a static public IP address:

  • URL: wss://
  • API Token: /112f7a4a-0051-cc2b-3b61-1898181b9950

To grant access only to certain devices, create a new user and select the necessary devices from the list. Then use the API token of that user. It is suggested not to use the API token of the admin.

You can use Z-Wave.Me UI with its enhanced Z-Wave network diagnostics tools together with the Home Assistant UI.

Hardware requirements

Z-Wave.Me Z-Way requires Z-Wave.Me hardware:

Installing Z-Way

Z-Wave.Me Z-Way runs on various platforms: Raspberry Pi OS, Linux, Windows. Installation instructions are available here: https://z-wave.me/z-way/download-z-way/

Migration to Z-Way

To migrate from any other Z-Wave controller to Z-Way, include Z-Way as a secondary controller (with security to let Z-Way learn the network key). Use the Z-Way migration tool to make the controller primary in your network.