2024.11.0
Home ▸ Integrations ▸

Z-Wave.Me

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, Zigbee, EnOcean, HTTP based, and others).

Configuration

To add the Z-Wave.Me integration to your Home Assistant instance, use this My button:

Z-Wave.Me can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Z-Wave.Me.

  • Follow the instructions on screen to complete the setup.

URL

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: 192.168.1.39:8083
  • 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://87.250.250.242:8083
  • API Token: /112f7a4a-0051-cc2b-3b61-1898181b9950

Warning

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.

Tip

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.