This page is part of archived documentation for openHAB 2.5. Go to the current stable version

# Wake-on-LAN Binding v1

The Wake-on-LAN binding allows you to turn on or wake up a computer by sending it a network message (opens new window).

# Prerequisites

For Windows computers not in a domain, the firewall must be configured properly (allow remote shutdowns) and the DWORD-Regkey LocalAccountTokenFilterPolicy in HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System must be set to 1.

# Binding Configuration

The Wake-on-LAN binding does not have a configuration file.

# Item Configuration

The syntax for the Wake-on-LAN binding configuration string is explained here:


NOTE: The <broadcast-IP> address is not the one from the machine you want to wake up - this is identified by MAC address. IP is the broadcast IP from the SubNet; Here some examples for a typical C class network: - for the destination IP - or for

Here are some examples of valid binding configuration strings:


As a result, your lines in the items file might look like the following:

Switch Network_OpenhabWebsite   "openHAB Web"   (Status, Network)   { wol="" }

# Examples

The item binding can be combined with an exec binding to be able to switch the system on and off. The example below works if openHAB is running on a windows host.

Switch networkPC "Computer" (network, gOGBuero) { wol="", exec=">[OFF:shutdown -s -m \\\\ -t 0 -f]" }

The example below is for openHab running on a linux host.

Switch networkPC "Computer" (network, gOGBuero) { wol="", exec=">[OFF:net rpc shutdown -C MESSAGE -I -U USER%%PASSWORD -f -t 120]" }