How to report a bug?

The better you report a bug, the better we can help you. Please follow the instructions below to make a report.

First search for the same symptoms and solutions over the Internet

Please use search engines! Also look into our forum. Still not found? Read further!

Where do you think the bug is in?

  • in Z-Way
  • in Z-Wave interoperability
  • in blue UI
  • in new UI
  • in API
  • in documentation

Are you sure it is a bug?

May be it is a feature? ;) Some software design solutions you might find not convinient at the first glance are made so especially to give you more flexibility and power!

Is it reproducable?

Please provide us exact instructions how to reproduce it. If you can't, but it happens unpredictably, try to find out some correlations — this will help us to find it our in our lab.

Which devices are involved in the test?

Can you reproduce it other devices of same type? Please note that some devices have their own problems no always conforming Z-Wave protocol and Z-Way just emphasizes them — this is not a problem of Z-Way!

Provide as much information as possible!

We need everything: version of Z-Way, logs, Z-Way queue photo (see image below), screenshots of the problem, descriptions about how to reproduce it, list of devices involved and their versions (see the screenshot below), your Linux or Raspbian distribution.

Where to send all the info?

We have separated RaZberry/Z-Way into many blocks and we are trying to keep these issues separated.

  • On the new Expert UI please report here. Note that Blue UI is not supported anymore.
  • About Home Automation UI (HA UI) please report here.
  • On Home Automation engine (JavaScript and modules) please post here.
  • For Android and iOS UIs
  • On problems in Z-Wave core engine (queueing, incomplete interview) here.
  • For TV web UI.

If you can not describe well the bug, please send all this at razberry(at)

How do I get the version of Z-Way?

  • check in the blue UI in For experts tab under Controller info (see image below)
  • do in the terminal:
    cd /opt/z-way-server; LD_LIBRARY_PATH=./libs ./z-way-server -h 2>/dev/null | head -n 1
  • look into the log, do in the terminal:
    grep /var/log/z-way-server.log | tail -n 1

Where do I get the log?

The log file is located in /var/log/z-way-server.log.

Shall I send you the full huge log file?

Please do not! Remove it, restart the software and reproduct your problem. Then stop Z-Way and send us the log.

How do I start/stop Z-Way?

In the terminal:

sudo /etc/init.d/z-way-server stop


sudo /etc/init.d/z-way-server start

How do I start Z-Way manually?

If you want to run Z-Way from the terminal (not via startup scripts), do the following:

sudo LD_LIBRARY_PATH=./libs ./z-way-server

You can add more command line params to change Z-Wave behaviour (add -h to see the list of available commands). By default Z-Way takes parameters from config.xml file.

How to report Linux/Raspbian information?

Please do:

file /bin/ls; uname -a


Z-Way version information
Z-Way queue inspector window
Device information seen in Z-Way

Compatible with new Model B+ and Raspi 2 and 3

RaZberry is compatible with old Raspberry Pi Model B as well as with new Model B+. 2 and 3. on Raspi 3 you cant use Bluetooth together with Z-Wave since both require a real hardware UART but Raspi 3 only has one.

Users Voice

Yesterday I received my Razberry, plugged it on my baseboard and was up and running. Great Work Guys! Saves me month of effort dealing with the low-level Z-Wave stuff.

Wayne Hunt, Moonlight Software

Z-Wave Book

The new Book about Z-Wave (264 pages) written by Dr. Christian Paetz, is now available at or It mentions a lot of the UI elements of the current RaZberry demo UI and is a great documentation about Z-Wave in general.