doc: Add a more complete Qemu example for new comers.

* doc/guix.texi (Running Guix in a VM): Update Qemu command example.

Signed-off-by: Gabriel Wicki <gabriel@erlikon.ch>

1 files changed, 31 insertions, 0 deletions

diff --git a/doc/guix.texi b/doc/guix.texi
index 15f6adfdb08..11138951c6d 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -51251,6 +51251,37 @@ name=com.redhat.spice.0
 You'll also need to add the @code{(spice-vdagent-service)} to your
 system definition (@pxref{Miscellaneous Services, Spice service}).
 
+Here is a working example with QEMU @samp{10.0.8}:
+
+@example
+qemu-system-x86_64 -nic user,model=virtio-net-pci -enable-kvm -m 2048 \
+  -device virtio-blk,drive=myhd \
+  -device virtio-serial-pci,id=virtio-serial0,max_ports=16,bus=pci.0,addr=0x5 \
+  -device virtserialport,nr=1,bus=virtio-serial0.0,chardev=vdagent,name=com.redhat.spice.0 \
+  -chardev spicevmc,name=vdagent,id=vdagent \
+  -spice addr=::1,port=5930,disable-ticketing=on \
+  -drive if=none,file=guix-system-vm-image-@value{VERSION}.x86_64-linux.qcow2,id=myhd
+@end example
+
+@quotation Note
+Without the @samp{addr=::1} of the @samp{-spice} option, it will listen
+on any IPv4 address (that is @samp{0.0.0.0}) on your host. And one might
+be able to connect to the guix VM from other host on your network.
+@end quotation
+
+@quotation Note
+QEMU will modify the .qcow2 image file while running. Back up the image
+file beforehand if you want to keep it untouched.
+@end quotation
+
+After running the above command, the terminal will stay in a blocking
+state, and to connect to the virtual machine, you can run the following
+command on a different terminal:
+
+@example
+remote-viewer spice://[::1]:5930
+@end example
+
 @node Defining Services
 @section Defining Services