Install the QEMU Guest Agent

Last updated October 14, 2024

To fully manage your Hostman server in the control panel, you need to have the QEMU Guest Agent installed. 

If the QEMU agent is not installed or is disabled, some control panel functionality will be unavailable, such as managing backups, snapshots, or SSH keys, resetting your root password, and others.

If you installed any software from the marketplace while creating the server, the QEMU guest agent will be installed automatically. Otherwise, you can install it manually by following this guide.

Checking for QEMU Guest Agent
Copy link

To check if the QEMU guest agent is installed on your server:

  1. Connect to the server via SSH.
  2. Run the following command:

If you have a similar output, it means the guest agent is up and running:

Powershell 25 Kh J1u Wr D

If the output looks like this, it means the agent is not installed:

Unit qemu-guest-agent.service could not be found.

In this case, the agent is installed but disabled—you need to restart it:

Active: inactive (dead) since ...

Restarting QEMU Guest Agent
Copy link

If you've already installed the QEMU guest agent but some features of the control panel are still unavailable, try restarting the agent. This will likely solve the issue.

  1. Connect to the server via SSH.

  2. Run the following command:

systemctl restart qemu-guest-agent.service

  1. Check that everything is working correctly with the following command:

systemctl status qemu-guest-agent.service

If everything is in order, the output will be as follows:

Powershell 25 Kh J1u Wr D

Installing QEMU Guest Agent
Copy link

To install the QEMU agent, connect to the server via SSH and run the appropriate commands for your operating system.

Ubuntu 18.04 and higher
Copy link

apt update && apt install qemu-guest-agent -y;

CentOS 9 Stream
Copy link

yum install qemu-guest-agent

Debian 8 and higher
Copy link

apt update;
apt install qemu-guest-agent -y