The QEMU Guest Agent is an essential component for communication between the host and QEMU-based virtual machines. It enables features like proper shutdown, filesystem freeze for snapshots, and improved VM management.
Prerequisites
A VPS with OnetSolutions
SSH or console access to your server
Root or sudo privileges
Installation Instructions Debian/Ubuntu
CentOS/Rocky/Alma
Windows Server
Install the QEMU Guest Agent
sudo apt install qemu-guest-agent
Start the service
sudo systemctl start qemu-guest-agent
Enable automatic startup
sudo systemctl enable qemu-guest-agent
Verify the installation
sudo systemctl status qemu-guest-agent
You should see a message indicating the service is active and running.
Install the QEMU Guest Agent
sudo yum install qemu-guest-agent
Or on newer systems with dnf: sudo dnf install qemu-guest-agent
Start the service
sudo systemctl start qemu-guest-agent
Enable automatic startup
sudo systemctl enable qemu-guest-agent
Verify the installation
sudo systemctl status qemu-guest-agent
You should see a message indicating the service is active and running.
Run the installer
Execute the downloaded qemu-ga-x86_64.msi file and follow the on-screen instructions. Accept the license agreement when prompted.
Verify the installation
Open Task Manager and look for the qemu-ga.exe process. If it’s running, the agent is installed correctly.
Configuration (Optional) On Linux systems, you can customize the QEMU Guest Agent behavior by editing its configuration file:
sudo nano /etc/qemu/qemu-guest-agent.conf
The default configuration works well for most use cases. Only modify this file if you have specific requirements.
Troubleshooting
Ensure the QEMU Guest Agent channel is enabled on your VM. Contact OnetSolutions support if the issue persists.
Agent not communicating with host
Restart the service and check the logs: sudo systemctl restart qemu-guest-agent sudo journalctl -u qemu-guest-agent
