# Getting Started

# Prepare Z-Way Server

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

# Prepare openHAB

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

  2. Install Z-Way Binding

    • via Extension Manager
    • via Download
    cd /opt/openhab2/addons
    sudo wget https://github.com/openhab/openhab-addons/files/636686/org.openhab.binding.zway-2.0.0-SNAPSHOT.zip
    sudo unzip org.openhab.binding.zway-2.0.0-SNAPSHOT.zip
    sudo rm org.openhab.binding.zway-2.0.0-SNAPSHOT.zip
  3. Start openHAB by running start.bat or start.sh

  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