This developer documentation isoutdated, but provides historical context.

It isnotuser documentation and should not be treated as such.

Documentation is available here.

Understanding Guest Agents and Other Tools


There are three tools which together can provide the best experience when using a virtual machine with oVirt.

  • oVirt Guest Agent - Recommended
  • VirtIO Drivers - Recommended
  • Spice Drivers - Recommended if you use the Spice console


oVirt Guest Agent

The oVirt Guest Agent provides information, notifications, and actions between the oVirt web interface and the guest. A more detailed description can be found at Guest Agent. The agent provides the Machine Name, Operating System, IP Addresses, Installed Applications, Network and RAM usage and others details to the web interface. The agent also provides Single Sign On so a authenticated user to the web interface does not need to authenticate again when connected to a VM.

Spice Agent

The Spice agent works with the Spice protocol to offer a better guest console experience. The Spice console can still be used without the Spice Agent. With the Spice agent installed the following features are enabled:

  • Copy & Paste of text and images between the guest and client machine
  • Automatic adjustment of resolution when the client screen changes - e.g. if you make the Spice console full screen the guest resolution will adjust to match it rather than letterboxing.
  • Better mouse integration - The mouse can be captured and released without needing to click inside the console or press keys to release it. The performance of mouse movement is also improved.


VirtIO Drivers

The VirtIO drivers provide a number of interfaces to guests. Further information can be found at

The drivers include support for

  • VirtIO Serial - Used for communication with oVirt Management
  • VirtIO SCSI - Used for communication with virtual SCSI disks
  • VirtIO Network - Used for communication with physical and virtual networks
  • Memory Ballooning - Used for freeing memory so that it can be made available to other VMs.

VirtIO is built into the Linux kernel so no additional installation is required for Linux VMs with recent kernels (2.6.35 and newer). For Windows VMs the drivers must be installed. The VirtIO drivers are available on an Windows VirtIO Drivers Wiki for easy installation to guests at run time and install time. Without the VirtIO drivers a Windows based VM can still function but it requires a IDE based virtual hard drive and e1000 or rtl8139 network devices which may not be optimal.

Availability & Install Instructions

Windows Guests

  Win XP Win 7 Win8 Server 2003/R2 Server 2008/R2 Server 2012/R2
oVirt Guest Agent Yes Yes Yes Yes Yes Yes
VirtIO Drivers Yes(1) Yes Yes Yes(1) Yes Yes
SPICE Drivers Yes Yes No(2) Yes Yes No(2)

(1) XP Does not support VirtIO-SCSI1 *(2) The SPICE drivers currently work with Windows 7 and below.

Linux Guests

  Fedora RHEL CentOS Ubuntu Debian openSuSE SuSE Linux Enterprise
oVirt Guest Agent Yes Yes Yes Yes Yes Yes Yes
VirtIO Drivers Built-in Built-in Built-in Built-in Built-in Built-in Built-in
SPICE Agent Yes Yes Yes Yes Yes - -