path: root/docs
diff options
authorMarc-André Lureau <>2014-03-19 17:02:28 +0100
committerMarc-André Lureau <>2014-03-19 17:14:44 +0100
commit06d646352efcf5b37c1bef09409ef52a0fb5dde2 (patch)
treed06087692b7d9782e898052600f08a060a749f17 /docs
parent2e730453bfe45636b611b86c2c619920f246977f (diff)
manual: add folder sharing section
Diffstat (limited to 'docs')
1 files changed, 56 insertions, 1 deletions
diff --git a/docs/manual/manual.txt b/docs/manual/manual.txt
index 27ad4c8..d8effd5 100644
--- a/docs/manual/manual.txt
+++ b/docs/manual/manual.txt
@@ -790,6 +790,61 @@ remote-viewer will pop up a window asking for a password before
starting the Spice session. It won't be established if an incorrect
ticket was passed to the client.
+Folder sharing
+The Spice client can share a folder with the remote guest. By default,
+the client will share the XDG Public Share directory, or '~/Public' by
+default. You may specify a different folder with `--spice-share-dir`
+client option.
+.Using virt-manager
+It's currently not possible to configure folder sharing with virt-manager.
+.Using libvirt
+In order to set up folder sharing, qemu needs to expose a
+`org.spice-space.webdav.0` virtio port, associated with a
+corresponding Spice port:
+ <channel type='spiceport'>
+ <source channel='org.spice-space.webdav.0'/>
+ <target type='virtio' name='org.spice-space.webdav.0'/>
+ </channel>
+.Using QEMU
+In order to set up folder sharing, qemu needs to expose a
+`org.spice-space.webdav.0` virtio port, associated with a
+corresponding Spice port:
+-device virtserialport,bus=virtio-serial0.0,nr=1,chardev=charchannel1,id=channel1,name=org.spice-space.webdav.0 -chardev spiceport,name=org.spice-space.webdav.0,id=charchannel1
+Guest configuration
+In a Windows guest, you must then install
+service, and register the drive (by running 'map-drive.bat' from
+'Program Files/Spice webdav').
+With a Linux guest, you must install the spice-webdavd service (the
+sources are available at The
+folder will show up in GNOME Files network places (or Nautilus). It
+can then be mounted and browsed in traditional applications thanks to
QEMU Spice reference
@@ -807,7 +862,7 @@ online documentation]. Basic syntax is `-spice <spice_options>`.
QXL command line options
- * ram_size
+ * ram_size
* vram_size
* revision
* debug