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)

  2. Install openHAB Connector

    cd /opt/z-way-server/automation/userModules
    git clone OpenHABConnector
    service z-way-server restart
  3. Instantiate the app once (under Configuration - Apps - Local Apps). Important: Change the selection from "Featured Apps" to "All Apps" to make the app visible. It is not necessary to make the configuration manually.

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 PaperUI

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.

  • openHAB
    • openHAB Alias by default, the alias is generated
    • IP address (default: localhost)
    • port (default: 8080)
    • protocol (default: http)
  • 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
    • Observer mechanism (default: active)

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