RomanNum3ral
/
quickemu
mirror of https://github.com/quickemu-project/quickemu.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Add known issue: SPICE display causes Windows guest freezes

Martin Wimpress 2026-01-23 15:03:42 +00:00
parent 5f35d7821d
commit f94e5cd4c9
No known key found for this signature in database
1 changed files with 21 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
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`.
- `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.