diff options
authorChristophe Fergeau <>2016-03-17 12:24:33 +0100
committerChristophe Fergeau <>2016-03-24 13:56:59 +0100
commit782c7508e28fdeee786cdcebffd22f772d7f09ec (patch)
parent6aaca6cf247f954128deead556cb38492a6e1a52 (diff)
doc: Add virgl documentation
Document how to use virgl with QEMU/libvirt virt-manager documentation still needs to be added.
1 files changed, 56 insertions, 0 deletions
diff --git a/docs/manual/manual.txt b/docs/manual/manual.txt
index 2c0035ac..a1c057ce 100644
--- a/docs/manual/manual.txt
+++ b/docs/manual/manual.txt
@@ -901,6 +901,62 @@ folder will show up in GNOME Files network places (or Nautilus). It
can then be mounted and browsed in traditional applications thanks to
+GL acceleration (virgl)
+OpenGL acceleration is currently local only (it has to go through a Unix socket)
+and it needs guest support. It's currently limited to recent linux
+distributions (for example up to date Fedora 23 + updated mesa packages from
+.Using libvirt
+You need to add a virtio-gpu video device to your virtual machine instead of QXL.
+ <model type='virtio' heads='1'>
+ <acceleration accel3d='yes'/>
+ </model>
+Then you need to enable OpenGL on your SPICE graphics node:
+<graphics type='spice' autoport='no'>
+ <gl enable='yes'/>
+You don't need any port/address as they won't be usable with
+.Using QEMU
+You need to add a virtio-gpu device on QEMU command line,
+as well as enable GL with SPICE. port/tls-port/addr arguments
+won't be used in this setup. You need to configure a Unix socket to
+connect to the VM display.
+-device virtio-vga,virgl=on -spice gl=on,unix,addr=/run/user/1000/spice.sock
+Connecting to the guest
+Connecting to the guest when virgl is in use is slightly different
+than usual
+.If libvirt is being used
+client$ virt-viewer -a $vmname
+.If a Unix socket has been set on QEMU command line
+client$ remote-viewer spice+unix:///run/user/1000/spice.sock
QEMU Spice reference