Wake-on-LAN icon

Wake-on-LAN

Send a Wake-on-LAN magic packet

Wake-on-LAN

AI-generated

Summary

Sends one or more Wake-on-LAN magic packets over UDP broadcast to wake a machine by its MAC address, once per input item.

Inputs

  • macAddress (required) — MAC address of the adapter to wake. Separators are stripped, so any format works, but it must contain exactly 12 hex characters. It is normalized to uppercase colon-separated form.
  • broadcastAddress — IPv4 broadcast address of the target network. Defaults to 255.255.255.255. Must be a valid IPv4 address, otherwise the item fails.
  • port — UDP destination port, 1–65535. Defaults to 9. Ports 7 and 9 are common.
  • repeatCount — Number of magic packets to send, 1–20. Defaults to 1.
  • delayBetweenPackets — Milliseconds to wait between repeated packets, 0–10000. Defaults to 100. Only applies when the repeat count is above 1.

Output shape

One output item per input item. Its json has a wakeOnLan object with macAddress (normalized), broadcastAddress, port and packetsSent. Each item is paired to its input item.

The node confirms only that the UDP send succeeded. It cannot confirm that the target woke up. If 'Continue On Fail' is enabled, a failed item returns json.error with the message. Otherwise the node throws a NodeOperationError. The node can also be used as an AI tool.

Examples

Example 1: Wake a home server on a typical LAN

macAddress=00:11:22:33:44:55, broadcastAddress=192.168.1.255, port=9, repeatCount=1

Example 2: Improve reliability for a slow-to-respond machine

macAddress=AA-BB-CC-DD-EE-FF, repeatCount=3, delayBetweenPackets=500

Example 3: Wake several machines from a list of items

macAddress set by expression {{$json.mac}}, with default broadcast and port

Links

Discussion