install Proxmox guest agent in Debaim

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:

  1. Select your VM
  2. Go to Options
  3. Find QEMU Guest Agent
  4. Click Edit
  5. Set it to Enabled
  6. 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.