Sign In
Sign In

Install the QEMU Guest Agent

Updated on 14 October 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

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

  1. Connect to the server via SSH.
  2. Run the following command:
systemctl status qemu-guest-agent

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

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

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

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

CentOS 9 Stream

yum install qemu-guest-agent

Debian 8 and higher

apt update;
apt install qemu-guest-agent -y
Was this page helpful?
Updated on 14 October 2024

Do you have questions,
comments, or concerns?

Our professionals are available to assist you at any moment,
whether you need help or are just unsure of where to start.
Email us
Hostman's Support