feat : Add support for Wake-on-LAN

Enables Wake-on-LAN by setting `wol_interface` to an empty string and enables MAC address reporting.
This commit is contained in:
2025-12-14 21:28:45 +01:00
parent 9bef606607
commit efd44fcbc8
4 changed files with 95 additions and 14 deletions

View File

@@ -11,12 +11,17 @@ This Ansible role enables persistent Wake-on-LAN (WOL) on a Proxmox VE server.
| wol_verify | true | Verify WOL status |
## Requirements
## Notes for Proxmox admins
Use the physical NIC, not vmbr0, unless your NIC supports WOL through the bridge
Common interfaces: eno1, enp3s0, eth0
Verify BIOS/UEFI: Enable Wake on LAN
Disable ErP / Deep Sleep
Auto-detection works best when:
The management IP uses the physical NIC
You are not routing management via vmbr0 only
If your default route is on vmbr0, manual override is recommended
BIOS must still have:
Wake on LAN enabled
ErP disabled
## Example Playbook
@@ -26,4 +31,4 @@ Disable ErP / Deep Sleep
roles:
- role: ansible_proxmox_WOL
vars:
wol_interface: vmbr0
wol_interface: vmbr0 # Optional, comment for autodetection