Getting Started

Prepare Z-Way Server

  1. Download Z-Way v2.2.3 or newer (further information about installing Z-Way you can find here)

Prepare openHAB

  1. Download openHAB 2 (further information about installing openHAB you can find here)

  2. Install Z-Way Binding

    • via Extension Manager
    • via Download
    cd /opt/openhab2/addons
    sudo wget
    sudo unzip
    sudo rm
  3. Start openHAB by running start.bat or

  4. The first start may take up to 5 minutes. You should reach openHAB2 at http://localhost:8080

Configure Z-Way in openHAB

Create and configure a Z-Way Bridge

Open the Paper UI

openHAB Home

Open the Inbox and create a Z-Way Server

openHAB Inbox

openHAB Inbox

Open the Configuration - Things and select Z-Way Server

openHAB Thing details

Change configuration: In order for the Observer mechanism works, the IP address, port and protocol of both systems are required.

  • Z-Way Server
    • IP address (default: localhost)
    • port (default: 8083)
    • protocol (default: http)
    • username (default: admin)
    • password must be set (no default value)
  • options
    • polling interval (default: 3600) in seconds

The following picture is no longer up to date! openHAB Thing settings

Create and configure Z-Way Devices

Open the Inbox and start manually the Discovery for the Z-Way Binding. The Discovery must be started manually at this point, because the Discovery is running only every 4 minutes. The start time of the interval is the creation of Z-Way Server, even if the configuration is not yet complete. After the Z-Way Server is fully configured, the interval must be awaited or started manually.

openHAB Discovery

openHAB Discovery

Create Things from the Discovery Results

openHAB Inbox

Example: openHAB Thing compared to the equivalent Z-Way Devices

openHAB Thing

Z-Way Devices