This is an automated email from the git hooks/post-receive script.
guix_mirror_bot pushed a commit to branch master
in repository guix.
The following commit(s) were added to refs/heads/master by this push:
new 67b1e5bfdb8 doc: Update 'Running Guix in a VM' instructions.
67b1e5bfdb8 is described below
commit 67b1e5bfdb85e093caae849557b21f6409f54660
Author: Maxim Cournoyer <[email protected]>
AuthorDate: Tue Sep 22 11:05:24 2026 +0900
doc: Update 'Running Guix in a VM' instructions.
Remove optional command parameters that would clash with those used by the
'guix system vm' script, and simplify Spice usage via the '-display
spice-app'
option.
* doc/guix.texi (Running Guix in a VM): Modernize and update examples.
Remove
obsolete note and manual remote-viewer invocation.
---
doc/guix.texi | 36 +++++++++++-------------------------
1 file changed, 11 insertions(+), 25 deletions(-)
diff --git a/doc/guix.texi b/doc/guix.texi
index cd99229183c..0144936dc5e 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -51769,47 +51769,33 @@ connect pass the @command{-spice
port=5930,disable-ticketing=on} flag to
Spice also allows you to do some nice stuff like share your clipboard with your
VM@. To enable that you'll also have to pass the following flags to
@command{qemu}:
+@macro spice-options-for-qemu
+-device virtio-serial \\
+-chardev spicevmc,name=vdagent,id=vdagent \\
+-device virtserialport,chardev=vdagent,name=com.redhat.spice.0 \\
+-display spice-app,gl=on -device virtio-gpu-gl -vga none
+@end macro
@example
--device virtio-serial-pci,id=virtio-serial0,max_ports=16,bus=pci.0,addr=0x5
--chardev spicevmc,name=vdagent,id=vdagent
--device virtserialport,nr=1,bus=virtio-serial0.0,chardev=vdagent,\
-name=com.redhat.spice.0
+@spice-options-for-qemu{}
@end example
You'll also need to add the @code{(spice-vdagent-service-type)} to your
system definition (@pxref{Miscellaneous Services, Spice service}).
-Here is a working example with QEMU @samp{10.0.8}:
+Here is a working example with QEMU @samp{10.2.1}:
@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
+-device virtio-blk,drive=myhd \
+-drive
if=none,file=guix-system-vm-image-@value{VERSION}.x86_64-linux.qcow2,id=myhd \
+@spice-options-for-qemu{}
@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
