qm-agent
execute commands via QEMU guest agent in Proxmox VE
TLDR
SYNOPSIS
qm agent vmid command
DESCRIPTION
qm agent is an alias for qm guest cmd in Proxmox VE. It executes commands through the QEMU guest agent (qemu-ga) running inside a virtual machine, enabling host-to-guest communication for operations like filesystem freeze/thaw, graceful shutdown, and information retrieval.
The QEMU guest agent must be installed and running inside the VM, and the agent option must be enabled in the VM configuration.
CAVEATS
The QEMU guest agent must be installed inside the guest OS and enabled in the VM configuration. On Linux guests, install the qemu-guest-agent package. On Windows guests, the agent is included with the VirtIO drivers. Communication fails if the agent is not running.
HISTORY
qm agent is part of Proxmox VE, the open-source virtualization platform. The QEMU guest agent protocol allows fine-grained control of VMs beyond what ACPI power management provides.
SEE ALSO
qm(1), qm-guest(1), qm-guest-exec(1)
