wtf is guix-qemu-adventures?

guix-qemu-adventures is a personal log of one person's experience running a Guix system disk image inside QEMU on a Mac. Guix is a Linux based operating system distribution, and this repository is not a packaged tool so much as a running notebook of commands, fixes, and gotchas encountered while getting it to work. The basic setup involves installing QEMU through Homebrew, downloading an official Guix disk image, generating an SSH key for logging into the guest system, and running a provided shell script to boot the virtual machine. A separate script boots the image with a graphical display instead of a plain terminal. Once running, the guest can be reached over SSH on a local port. Most of the README is a running log of specific problems and their fixes: sharing a local folder into the virtual machine using a filesystem protocol called 9p, formatting Guix configuration files, building a new disk image from a configuration file, which can take around 18 minutes, and enlarging a disk image that ran out of space, including steps taken both from outside and inside the guest. Other entries cover clipboard behavior differing between graphical and text only modes, fixing SSH host key warnings after the guest's identity changes, working around an error during a Guix update by pointing at an alternate package mirror, shutting down and rebooting the guest, reconfiguring the system from a configuration file, booting into an older system generation from the boot menu, and shrinking a disk image back down after cleanup. There is also a section comparing display protocols, noting that a separate tool called UTM supports the SPICE display protocol on macOS out of the box, which the author found preferable to VNC for folder sharing and clipboard support with plain QEMU. This is best used as a reference for anyone hitting similar problems while running Guix under QEMU on macOS. No license is stated.