The openHAB Documentation Has Moved

The documentation has moved to and

Please use the link below to be redirected to the new version of this article, and update your bookmarks.

Wake-on-LAN Binding

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


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="" }


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]" }