diff --git a/04-Create-Windows-virtual-machines.md b/04-Create-Windows-virtual-machines.md index 5b02948..4e77caf 100644 --- a/04-Create-Windows-virtual-machines.md +++ b/04-Create-Windows-virtual-machines.md @@ -41,4 +41,24 @@ secureboot="off" - `guest_os="windows"` instructs `quickemu` to optimise for Windows. - `fixed_iso=` specifies the ISO image that provides VirtIO drivers. -- `tpm="on"` instructs `quickemu` to create a software emulated TPM device using `swtpm`. \ No newline at end of file +- `tpm="on"` instructs `quickemu` to create a software emulated TPM device using `swtpm`. + +# Known Issues + +## SPICE display causes freezes + +Windows 10 and Windows 11 guests may freeze approximately 20 seconds after boot when using `--display spice`. The freeze typically occurs when interacting with the VM, such as opening files or a web browser. + +**Workaround**: Use the default SDL display instead of SPICE: + +```shell +# Instead of this (causes freezes): +quickemu --vm windows-11.conf --display spice + +# Use this: +quickemu --vm windows-11.conf +``` + +**Trade-off**: Window resizing and SPICE-specific features (clipboard sharing, USB redirection via SPICE) will not be available with SDL display. + +This appears to be an upstream SPICE/QEMU limitation rather than a quickemu bug. See [issue #1670](https://github.com/quickemu-project/quickemu/issues/1670) for details. \ No newline at end of file