Skip to content
HostupDevelopers
GuidesAPI referenceSupport

guest_agent_unavailable

Guest Agent unavailable. HTTP status 409.

The command could not run because the QEMU Guest Agent inside the VPS does not respond. It may not be installed or running, or it may be busy.

What to do

Install and start the qemu-guest-agent package inside the VPS, for example over SSH. Then retry the command. If it is already running, wait a moment and retry.

What the message says

  • QEMU Guest Agent is not available right now. Make sure it is installed and running before executing commands.

Example

Response 409
{
  "type": "https://developer.hostup.se/errors/guest_agent_unavailable",
  "title": "Guest Agent unavailable",
  "status": 409,
  "detail": "QEMU Guest Agent is not available right now. Make sure it is installed and running before executing commands.",
  "code": "guest_agent_unavailable",
  "requestId": "req_01hxa3b4c5d6e7f8g9h0j1k2m3"
}

Branch on code, not on title or detail. When you contact support about it, include the requestId. More in Errors and retries.

Endpoints that return it