v4.6.2

[osy]

Highlights

• QEMU v9.1.2 The backend has been updated to the latest upstream QEMU which brings with it a variety of bug fixes and performance improvements.
• (macOS 15) Nested virtualization for Linux Linux VMs using Apple Virtualization backend on macOS 15 and M3 or newer will now have nested virtualization enabled by default.
• (macOS 15) Total Store Ordering for QEMU VMs using QEMU backend on macOS 15 can now enable TSO (in QEMU settings) at the hypervisor level. When TSO is enabled on a guest operating system that is aware of the system register (i.e. Rosetta for Linux), performance of Intel emulation within the guest can be greatly improved. Note that if the guest kernel supports dynamically toggling TSO, you do not need to enable this.
• (macOS 15) Improved macOS guest support The last window size (including full screen size) will be restored when the guest supports dynamic resolution. Removable drives and shared directories can now be ejected and changed while the macOS VM is running. Copy/paste synchronization between macOS 15 guest and host now works when the guest tools are installed (from the CD icon in the toolbar).

Notes

• (macOS) There is a known issue with macOS 15.0 and 15.0.1 where accesses to files will fail due to a permission error. This issue has been resolved with macOS 15.1.
• (macOS) There is a known issue on M4 series of Macs where virtualization fails for macOS guests older than 13.4. The issue should be addressed by Apple in a future update. (#6794)
• There is a known issue (#6332) with Windows 11 24H2 that causes the display to show a black screen or "Guest has not initialized the display (yet)" upon boot. We recommend not upgrading to 24H2 for existing installs and 23H2 for new installs. If you have already upgraded, please follow the workaround described in the linked issue.
• The default CPU for x86_64 emulation and virtualization will now try to match the architecture of your system or the highest architecture that QEMU supports. For example, a 2016 MacBook Pro or newer will now emulate a "Skylake" based processor instead of a generic x86_64 processor. This should improve compatibility and performance of newer operating systems but may cause issues with older operating systems. If you run into issues, you can manually change the CPU model to an older one in the VM's System settings.
• The update to QEMU v9.1.2 will likely introduce other issues and regressions. If you experience any problem (crashes, performance, errors) that was not evident in v4.5.x, please open an issue and provide all the requested information. It would also be helpful if you can provide a reproducible example and note the last version of UTM where it worked properly.

Changes (v4.6.2)

• Updated QEMU to v9.1.2 and fixed a crash during Windows setup (x86_64) (ERROR:../target/i386/tcg/translate.c:731:gen_helper_in_func: code should not be reached in qemu-system-x86_64 #6835)
• Fixed a race condition that causes starting VM to fail with "QMP stream error seen"
• (iOS) Fixed DEB install
• (iOS) Fixed a crash when the main bundle executable is not the same as the currently running executable
• (iOS) Fixed a crash on iOS 18 due to namespace collision with internal names
• (iOS) Fixed auto-zoom to fill screen not properly working when Display Zoom is used (Guest display zooms incorrectly if iPad display zoom not set to Default #6736)
• (macOS) Fixed TSO mode not working in QEMU
• (macOS) Fixed slow virtualization issues on Intel Macs (Virtualization is significantly slower than emulation #6325)
• (macOS) Fixed boot issues with Windows 11 24H2 (x86_64) (Windows 11 24H2 Installer goes into a boot loop on Intel Mac #6772)
• (macOS) Support > 32GiB RAM configurations in QEMU (VM Startup (QEMU RAM Allocation) Errors with High (>32GB) RAM on M2 Max Macbook #5537)

Changes (v4.6.1)

• Updated SPICE GTK to v0.42, libsoup to v3.6.0, and phodav to 3.0
• Fixed an issue where an empty and broken .utm package is created when creation of VM fails
• Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon)
• Localization: Updated Japanese (thanks @MMP0)
• (macOS) Fix fullscreen button showing up as zoom when the dock icon is disabled (thanks @ntoskrnl) (Partial fix for the #5535 – The issue with full screen not working when dock icon is hidden #6269)
• (macOS) Fixed an issue "With SME enabled, at least one vector length must be enabled." when an M4 series Mac is running macOS 15.2 beta (MacBook Pro M4: QEMU error: QEMU exited from an error: With SME enabled, at least one vector length must be enabled. #6790)
• (macOS) Fixed permission issue with EFI vars when installed with Nix (Linux fails to boot in QEMU VMs when UTM is installed by Nix #6725)
• (macOS 13) Enable changing shared directory for newer macOS guests ("Shared folder" button blurred when booting MacOS Sequoia guest #6807)
• (macOS) Fixed a memory leak caused by an event listener not unregistering after the VM window is closed
• (macOS) Support saving and restoring dynamic resolution when the guest supports it (both QEMU SPICE based and Apple Virtualization based guests)
• (macOS) Scripting: added new import and export commands to the Apple Script interface as well as extra QEMU args to the configuration for a new VM (thanks @naveenrajm7) (scripting: add export command #6716, scripting: add import command #6734, scripting: add qemu additional arguments #6741)
• (macOS) Scripting: Fixed a crash when an invalid .utm package is found
• (macOS 15) Virtualization: Fixed nested virtualization not being set (Nested Virtualization on Mac OS 15.1 #6789)
• (macOS 15) Virtualization: Support ejecting and changing removable drives while the VM is running
• (macOS 15) Virtualization: Support installing guest tools for macOS guests
• (macOS 15) Virtualization: Support copy-paste on macOS 15 guests when guest tools is installed
• (macOS) Home: Fixed alerts not showing up
• (macOS) Home: Fixed VM download confirmation not showing up when wizard is open (Quick start window blocks download #6820)

Changes (v4.6.0)

• Updated to QEMU v9.1.0
• Fixed "RPC timeout" when stopping a VM
• Fixed a race condition when cleaning up SPICE objects
• Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon)
• (iOS 16+) Home: Always show the sidebar
• (macOS 15) Enable nested virtualization when available

Issues

Please check the full list on Github and help report any bug you find that is not listed.

Installation

• iOS
• macOS

File	Description	Installation	JIT	Hypervisor	USB
UTM.deb	Jailbroken iOS version	Open in Cydia, dpkg, or Sileo	Yes	Yes(1)	Yes
UTM.dmg	macOS version	Mounting and copying UTM.app to /Applications	Yes	Yes	Yes
UTM.ipa	Non-jailbroken iOS version (sideloading)	AltStore, etc (see guide)	Yes(2)	No	No
UTM-HV.ipa	Non-jailbroken iOS version (TrollStore)	TrollStore	Yes	Yes(1)	Yes
UTM-SE.ipa	Non-jailbroken iOS version (sideloading)	AltStore, enterprise signing, etc	No	No	No
UTM-Remote.ipa	Remote client	Any	No	No	No

1. Hypervisor on iOS requires an M1 iPad or newer.
2. Enabling JIT may require a separate JIT enabler such as Jitterbug or Jitstreamer.

---

This discussion was created from the release v4.6.2.