Installation on Raspberry Pi
Before you can use the RaZberry solution, you need to complete your gateway hardware
and install the software.
Here are two ways to install and start Z-Way:
- A: You do not have Linux OS on your Raspberry Pi installed yet. Please download
an SD card image (minimum 8 GB) from the download section of
. It is based on the Raspberry Pi distribution “Jessie.’’
- B (recommended): You already have a working Linux (Jessie) running. Log in and
execute the following command line:
wget -q -O - https://storage.z-wave.me/RaspbianInstall | sudo bash.
You may need to configure the Wi-Fi access point of your Raspberry Pi in order to allow
direct wireless access.
Installation on other platforms using UZB
Let’s assume you already have shell access to your system. You can download a binary
Folder Content of Z-Way
and unpack it. The code can run on every place in the filesystem. Nevertheless, we
recommend using /opt/z-way-server as the folder to store the codebase. The
folder content looks as shown in Figure 3.1. For more information on the
files and the file structure of Z-Way, please refer to Chapter 11.4.
Z-Way can then be started using the simple shell command from inside the Z-Way folder:
Once the code is started, it is possible to access the standard user interface using
To use Z-Wave, the correct port of the Z-Wave transceivers virtual serial port must be
configured. Please go to the user interface menu and open the app 'Z-WAY NETWORK ACCESS'
as shown in Figure 3.2. for more information about Z-Way aps please refer
to Chapter 6.
Z-Wave Network Access App
After checking the right virtual port created by the operating system, please configure
this port name and save the settings. Now Z-Way should be up and running, and you may
want to create a startup script to make sure Z-Way is running right after booting.
First, note that the Windows platform is only partly supported. There is a binary distribution
for Windows, but it certainly lacks the level of testing required. Please use the binary
Windows distribution at your own risk.
Z-Way Windows Setup Wizard
Install the MSI file and start it. You will see a nice wizard—see Figure 3.3
—guiding you through the setup process.
Z-Way Windows Installation
The files are installed on the folder of choice as shown in Figure 3.4.
Windows Hardware manager with new COM port
If the UZB stick is plugged into the system, there is a new COM port created for this stick.
Figure 3.5 shows the Windows hardware manager with the new port. After passing
the initial setup page, open the app 'Z-WAY NETWORK ACCESS' and double check the
right COM port. Note that there is a very special syntax for the COM port
'\\.\COM3' for serial port 3.
Figure 3.6 shows this dialog.
Z-Wave Network Access App with COM Port
Under Windows, Z-Way runs as a service. You find the service entry in the Windows Service
Management as shown in Figure 3.7. This dialog also allows starting and stopping
Z-Wave as Windows service
Local and Remote Access
Z-Way can be accessed in several ways:
- Using a standard web browser on the controller’s IP address. There is an
embedded webserver on Port 8083 providing the web pages of the user interface.
- Using a standard web browser but the redirection service
user interface is similar, but there is no need to be on the same IP network or to
install an explicit port forwarding.
- Use one of the native apps from Google Playstore or Apple iTunes. These will,
however, use the two same services for local and remote access as mentioned above and
will only render the user interface differently.
- Use your own web or native app-based user interface. Again, you will then use one
of the two options mentioned above.
Both the local access and the remote access using the find-service have their pros and
cons as listed in Table 3.1:
Comparison of Access methods
|Local IP Ethernet
|very fast, all data stays within own home
|no secure connection due
to missing IP certificates, IP address must be known, no access from outside the home
|worked independent of local network setting from everywhere, very safe
due to complete end-2-end security
|depends on external service, more delays
|Local IP WIFI
|very fast and secure
|another WIFI access point, no access from outside the home
The initial access to the user interface must be done using one of the local access routes.
Once Z-Way is running, the first access to the interface asks for some basic setup such
as the admin password and an email address to recover this password. Figure 3.8
shows this screen.
The number provided in the title (1) is the unique Z-Way Platform ID of the device and it will be needed
in the future to access the controller remotely using the find service.
The on the upper right side
allows changing the interface language from
standard English to your chosen language. If your language is not yet available, you
may want to consider contributing a translation. Please refer to Chapter 10.3
for details on how to do this.
Initial setup of the Z-Way User Interface
The language selection can be used for the user interface from this time on, but it can
be changed in > My Settings.
Please note that the email address provided for email recovery will not be stored outside
your controller, e.g. in a cloud service. This provides extra security but also means that
certain processes like restore are a bit more complicated than is usual.
After completing the setup, a welcome screen will guide you through the system and
introduce the basic user interface terms/dialogs.
- Element View,
- Element Configuration,
It also offers buttons for direct access to the two most common actions right after installation:
- Add a new physical device.
- Add some virtual device, internet service or application.
After completing the setup, it is possible to access Z-Way using the find service, or install
a native app for the mobile phone. Open the url
The dialog on this find service, as shown in Figure 3.10, is intentionally
simple. It offers two ways to log in:
- Using your Z-Way Platform ID , along with your login name (Example: '23333/admin') and
your password for remote login and redirection
- In case you use the service from a PC or a mobile phone within your home, the
service will detect this and show the IP addresses of your Z-Way controllers. It
is possible that a Z-Way controller has two IP interfaces (Ethernet + Wi-Fi). In
this case, both addresses are shown. Clicking on the IP address will lead to the
local IP login screen, as shown in Figure 3.9, where only name (e.g. admin) and
password are required.
Login on local IP address
Remote Login Screen
The menu option Logout in the setup menu of the user interface will terminate
the session and return you to the login screen or the find service depending on how to
log in. You can always force the termination of the find session by calling the
Security and Privacy
Security and privacy are of great importance. Z-Way tries to maximize security and privacy
and will not compromise them in order to improve user experience and convenience.
- All user data including login name and email address are stored only locally, which
means that the controller must be available and connected to restore passwords. We
believe that this is a robust security and privacy measure.
- Z-Way offers certain cloud-based services. This requires certain services and
connections to the Z-Way cloud service:
- Right after boot-up, the Z-Way controller will connect to the find service
announcing its presence. This is done using a reverse ssh service. The client side of this
service is available on the Z-Way server and you can review its work and source code.
If you don’t like this service, you can turn it off using the Z-WAY SMART HOME INTERFACE .
However, be prepared not to have the find service available anymore.
- The backup to cloud service will also create a copy of your device data on the
cloud service. This is very convenient and ensures that you have a backup file when
needed. If you feel uncomfortable leaving a copy of your smart home configuration
on the Z-Way cloud service, just don’t use this service and turn it off.
- The find service allows https connection and provides a valid certificate issued by
COMODO RSA Domain Validation Secure Server CA. Please check the validity of the
certificate before using the find service. This means that the access using the find
service has established a complete secure connection from the web browser via the
find service to your controller at home.
- There is no https access enabled to the local port. This is because there is no way
to create a valid certificate on an IP address that is assigned dynamically using DHCP.
It would still be possible to run encryption with https, but we believe that this would
be mimicking security without having real security. That’s why we only keep http to
send a clear message about the risk of accessing a local IP address. We strongly
recommend doing an initial password setting and subsequent local access using Wi-Fi
only since Wi-Fi comes with its own very secure encryption based on WPA.
- We recommend Chrome, Firefox, or Safari
since we frequently see problems with MSIE.