Step 1 – Install the QEMU Guest Agent inside Debian
sudo apt update
sudo apt install qemu-guest-agent -y
Step 2 – Enable and Start the Service
sudo systemctl enable qemu-guest-agent
sudo systemctl start qemu-guest-agent
Check its running
sudo systemctl status qemu-guest-agent
Step 3 – Enable the Guest Agent in Proxmox
Now switch to the Proxmox web interface:
- Select your VM
- Go to Options
- Find QEMU Guest Agent
- Click Edit
- Set it to Enabled
- Reboot the VM (recommended)
Step 4 – Confirm It’s Workin
After reboot:
- In Proxmox → VM → Summary
- You should now see the VM’s IP address populated
- Shutdown from Proxmox should now perform a clean OS shutdown
You can also test from Proxmox shell:
qm agent ping
If it replies, it’s working.