Instalar o QEMU Guest Agent

Última atualização em 5 de fevereiro de 2026

Para gerenciar totalmente seu servidor Hostman pelo painel de controle, é necessário ter o QEMU Guest Agent instalado.

Se o agente QEMU não estiver instalado ou estiver desativado, algumas funcionalidades do painel de controle não estarão disponíveis, como gerenciamento de backups, snapshots ou chaves SSH, redefinição da senha root, entre outras.

Se você instalou algum software pelo marketplace durante a criação do servidor, o QEMU Guest Agent será instalado automaticamente. Caso contrário, você pode instalá-lo manualmente seguindo este guia.

Verificar o QEMU Guest Agent

Para verificar se o QEMU Guest Agent está instalado no seu servidor:

Conecte-se ao servidor via SSH.
Execute o seguinte comando:

systemctl status qemu-guest-agent

Se a saída for semelhante a esta, significa que o agente está ativo e em execução:

Se a saída for parecida com a seguinte, significa que o agente não está instalado:

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

Se aparecer algo como:

Active: inactive (dead) since ...

isso significa que o agente está instalado, mas desativado — será necessário reiniciá-lo.

Reiniciar o QEMU Guest Agent

Se o QEMU Guest Agent já estiver instalado, mas alguns recursos do painel de controle ainda não estiverem disponíveis, tente reiniciar o agente. Isso provavelmente resolverá o problema.

Conecte-se ao servidor via SSH.
Execute o seguinte comando:

systemctl restart qemu-guest-agent.service

Verifique se tudo está funcionando corretamente:

systemctl status qemu-guest-agent.service

Se tudo estiver correto, o serviço aparecerá como ativo: