ansible_proxmox_WOL/README.md

# ansible_proxmox_WOL

This Ansible role enables persistent Wake-on-LAN (WOL) on a Proxmox VE server.

## Variables

| Variable | Default | Description |
|--------|---------|-------------|
| wol_interface | eno1 | Network interface |
| wol_mode | g | WOL mode (magic packet) |
| wol_verify | true | Verify WOL status |


## Notes for Proxmox admins

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

```yaml
- hosts: proxmox
  become: true
  roles:
    - role: ansible_proxmox_WOL
      vars:
        wol_interface: vmbr0    # Optional, comment for autodetection