Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
92 lines (67 sloc) 2.71 KB


Creates a switch that controls and checks the status of a remote host.

  • Turning on is done via Wake on LAN. Since WOL packets are not routable, zway and the target host must reside in the same network.
  • Turning off is handled via SSH. You must ensure that the user running zway (usually root) has its public SSH key on the target machine
  • Checking is done via ping



IP address of the remote host (must be in the same network)


Username for the remote host


MAC address of the remote host


No events are emitted

Virtual Devices

This module creates a virtual binary switch that turns on/off a remote Linux host. The state of the host is checked regularly by pinging the ip addres.


Install ethtool to get Wake on LAN (make sure that WOL is enabled on the remote host). On debian(raspbian) this can be done running this command

sudo apt-get install ethtool

Create a SSH key pair and copy the public key to target machine

sudo su # change to the user running zway (usually root)
ssh-keygen -t rsa -b 3072 -C ""
ssh-copy-id -i ~/.ssh/ remote-host

The prefered way of installing this module is via the " App Store" available in 2.2.0 and higher. For stable module releases no access token is required. If you want to test the latest pre-releases use 'k1_beta' as app store access token.

Allow module to call the remote host command and make helper executable

echo '/opt/z-way-server/automation/userModules/RemoteHost/remotehost' >> /opt/z-way-server/automation/.syscommands
chmod a+x /opt/z-way-server/automation/userModules/RemoteHost/remotehost

For developers and users of older Zway versions installation via git is recommended.

cd /opt/z-way-server/automation/userModules
git clone RemoteHost --branch latest

To update or install a specific version

cd /opt/z-way-server/automation/userModules/RemoteHost
git fetch --tags
# For latest released version
git checkout tags/latest
# For a specific version
git checkout tags/1.02
# For development version
git checkout -b master --track origin/master


This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.

Computer tower icon by Zlatko Najdenovski from the Noun Project

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You can’t perform that action at this time.