v4.0.6 (RC)

[osy]

Remember to back up your VMs before running a beta release of UTM!

Highlights

• Multiple display and headless display is now supported for QEMU machines. You can configure 0 or more displays as well as 0 or more builtin terminal consoles. On macOS, a new window will be created for each display and builtin terminal. On iOS, you can create multiple windows (iPad) as well as plug in an external display or AirPlay (iPad or iPhone) and assign outputs to each window.
• Ventura updates to Virtualization. macOS Ventura introduces new features to Virtualization.framework that is now integrated into UTM. You can now create GUI Linux VMs with EFI boot. Clipboard sharing and directory sharing now works with macOS Ventura guests. Rosetta x86_64 emulation is supported for Linux VMs on Apple Silicon.
• VirtFS sharing for QEMU. This can be enabled in the VM settings under Sharing. You can mount the tag "share" in the VM. Note that macOS UID are numbered differently than Linux so you may need to set up your guest to have permission to access the shared directory.
• Easier Windows 10/11 installation and Windows guest tools downloader. You can now download and mount the Windows drivers and guest tools ISO image with a single click (macOS: disk icon in VM window, iOS: 3D touch context menu on home screen). Additionally, the ISO now include an "Autounattend.xml" which is recognized by the Windows 10/11 installer. When mounted to a second CD drive, the installer will install the correct drivers, bypass secure boot/TPM requirements, and launch the SPICE tools installer on first login.
• (macOS) Resize QEMU disk images. In the drives settings page, you can now expand the size of the QCOW2 disk image.
• (iOS) QEMU Virtualization for M1 iPad. With the release of TrollStore, you can now enable Hypervisor on iOS. Note that only M1 hardware and kernel have support for Hypervisor. iOS 14.4.2-14.5.1 is supported only on M1 iPad Pro jailbroken with fugu14/unc0ver. iOS 15.0-15.1.1 is supported on any M1 iPad running TrollStore.

Notes

• iOS 14 and macOS 11.3 are the new minimum supported systems. Please use UTM v3.x for support down to iOS 11 and macOS 11
• The configuration backend has been massively rewritten. Please backup all VMs prior to updating as you will not be able to re-open VMs saved by UTM v4 on older versions of UTM if you decide to downgrade.
• Since v4.0.6, the order of generated devices has changed to always create network devices first. This is to address an issue on some distributions (such as Ubuntu) where adding a device (drive, display, etc) would require re-configurating the network because the device name changed. Unfortunately, this change will cause the configuration issue to occur once more on any existing VM that is susceptible to the network issue. On Ubuntu, this will require you to modify /etc/netplan/00-installer-config.yaml and change the adapter name from enp0s9 (or whatever it is currently) to enp0s1 (which reflects the new device ordering). Other Linux distributions may require a similar change. However, after updating the guest network configuration, you should no longer have issues with networking when making device changes to the VM.

Changes (v4.0.6)

• Fixed an issue in argument generation where PS/2 input was forced even when USB was enabled (Cursor options doesn't work #4424)
• Validate settings on save before closing the settings dialog
• Network devices are now created first before all other devices. Note this means that networking will be broken on some existing VMs and must be re-configured! (See notes above)
• Fixed a deadlock issue when saving settings
• Fixed an error when saving a VM with an external drive selected
• Translation: Updated Japanese (thanks @MMP0)
• Translation: Updated French (thanks @FRtranslator)
• Wizard: The Windows guest tools auto-installer currently only works on Windows 10 and above. A new option is added in the wizard to make this explicit. (Unattended xml does not work on Windows 7 #4440)
• Wizard: Use VirtFS sharing by default when Linux is selected
• (iOS) Default to emulated network instead of failing when importing a VM created on macOS
• (macOS) Fixed an issue where opening a new display window from a serial window did not work
• (macOS) Fixed logic on macOS 11 where serial window was not created
• (macOS) Fixed a crash on macOS 11 when saving settings while the QEMU tab is selected
• (macOS 13) Support clipboard sharing on Linux with Apple Virtualization when spice-vdagent is installed
• (macOS) Fixed an issue changing the boot OS where the incorrect image type is prompted
• (macOS) Perform settings validation when launching an Apple Virtualization VM to ensure selected features are available
• (macOS 12+) Set a machine identifier when launching an Apple Virtualization VM
• (macOS 13) Emulate trackpad on macOS guests with Apple Virtualization
• (macOS) Fixed an issue when a newly created VM will not launch on macOS 11

Changes (v4.0.5)

• Fixed moving an existing VM with Hypervisor enabled to a device on a different architecture. The VM will fallback to TCG and the option to disable hypervisor in settings is allowed. (Unable to disable hypervisor option on different architecture #4407)
• Translation: Updated Japanese (thanks @MMP0)
• (iOS) Fixed an issue that prevented external keyboards from working (External keyboard broken in home view #4399)
• (iOS) Detect Hypervisor support on jailbroken devices so the option is not inadvertently enabled on non-supported devices
• (iOS) Support Hypervisor on M1 iPad running jailbroken iOS 14.5

Changes (v4.0.4)

• Fixed in issue generating configuration for IDE drives leading to PPC not booting and I/O errors on PC (UTM 4.0.3 Beta issue on MS-DOS #4372, Emulation bugs on 4.0.3 but not on 4.0.2 #4376, others)
• Moved the SPICE tools download directory to "GuestSupportTools" under "Application Support" (previously it was just under "Application Support")
• Fixed creating a VM with illegal path characters in the name (Using a forward slash in the name of a VM fails creation #4385)
• Translation: Updated Japanese (thanks @MMP0)
• Translation: Updated French (thanks @FRtranslator)
• Wizard: No longer tries to download the Windows guest tools when selecting a non-Windows OS
• (iOS) Enable build with Hypervisor.framework (support limited to M1 iPad)
• (iOS) Fixed a crash when switching display in a window
• (iOS) On jailbroken devices, the memory limit will automatically be increased to the maximum, preventing the Jetsam system from terminating UTM for memory usage
• (iOS) Fixed a regression which caused the home indicator to not be hidden (iOS: hide home indicator #4390)
• (iOS) Fixed a regression which caused the cursor to not be captured (iOS: hide home indicator #4390)
• (iOS) When switching display, notification handlers are properly cleaned up (example: cursor capture and console on screen keyboard events)
• (iOS) Show the device cursor when VM is paused
• (iOS) Fixed a regression where external keyboard events are not captured
• (iOS) Fixed an error where extraneous stale VM entries show up after the container name changes (iOS: force quitting sometimes causes duplicate VMs to show up #4392)
• (iOS) Fixed a crash on iOS 14 when opening a terminal view due to SwiftTerm handling the colour configuration
• (macOS) Fixed a layout issue of the compress/resize buttons
• (macOS) Forgot to actually enable compression for the drive setting button (Reclaiming space not working, disk image increases by 3 fold [v4.0.3] #4377)
• (macOS) Fixed some settings layout issue on < macOS 13 (Config window text and control elements alignment issues [v4.0.3] #4374)

Changes (v4.0.3)

• Fixed an issue where changing external drive/shared directory for a QEMU VM -> exit UTM -> reopen UTM and start the VM results in the drive/share not being restored
• Disable changing a VirtFS share from the home window (this is not an supported operation)
• Better detection of UUID collision which addresses an issue where VMs with the same UUID do not show up on the home screen and other VMs show up as duplicates and clicking on any of them results in a freeze
• Fixed floppy drive argument not being correctly generated (Floppy drive not being read #4362)
• Fixed an issue where ejecting an external drive or shared directory does not persist
• Fixed a memory issue when stopping or closing VMs causing UTM to crash
• Fixed a regression where an access error occurs after moving a VM
• Added the ability to download the Windows SPICE tools and drivers automatically (Bundle and auto-install SPICE tools for Windows #4364)
• Added support for more than 2 IDE drives in PC emulation
• Restored the setting to turn off blinking cursor (UTM v4: Console cursor fading in and out, and console is smaller #4296)
• Translation: Updated Japanese (thanks @MMP0)
• Wizard: Reworked some of the UI, text, and file selection
• Wizard: Add option to auto download and mount the SPICE tools to a second CD drive
• Wizard: Fixed an issue where the selected boot image and shared directory was not saved on the new VM
• Wizard: Recommend UUP built ISO over the VHDX by default
• Wizard: New "confused user" check will catch trying to mount an "amd64" ISO on an "arm64" guest or vice versa
• (iOS 16) Use the new NavigationSplitView for a slightly polished look
• (iOS 16) Fixed an issue where the bottom toolbar does not show up (iOS 16: Toolbar not showing up #4325)
• (iOS) Fixed an issue where the file importer was not opening (Cannot select shared directory in iOS 15.6.1 #4365)
• (iOS 14) Fixed an issue in the settings screen where multiple drives were occupying a single cell
• (iOS 14) Fixed an issue where UTM may crash when adding a drive or hardware
• (macOS) Added the ability to re-open closed windows for a given VM (Reopen closed display in macOS #4351)
• (macOS) Fixed an issue where restarting a VM results in duplicate windows (Restarting VM opens a new display window #4367)
• (macOS) Save the size of terminal windows (UTM v4: Console cursor fading in and out, and console is smaller #4296)
• (macOS) Add resize QCOW2 image feature (thanks @stewartsmith)

Changes (v4.0.2)

• Removed "view.plist" for host-specific configuration settings (i.e. bookmarks to removable drives and window options) and replaced it with a new "registry" that is stored outside of the .utm bundle. Old "view.plist" settings and bookmarks will be migrated to the registry on first launch and the file will be deleted from the .utm bundle. For Apple VMs, the bookmarks will no longer be stored in config.plist and the settings will be migrated to the registry as well.
• VirtFS no longer requires SPICE to be enabled (thanks @tie)
• Fixed an issue with PPC VMs not showing 256 colours correctly (PowerPC does not work with 256 colours #4277)
• Fixed incorrect parsing of CPU flags (Property 'Penryn-x86_64-cpu.AnyQEMUConstant(rawValue: "ssse3")' not found #4282)
• Do not save screenshots when running in disposable mode
• Translation: Added Spanish (Latin America) (thanks @JezerM)
• Translation: Added Finnish (thanks @marcusziade)
• Translation: Updated Japanese (thanks @MMP0)
• Translation: Updated Chinese (Simplified) (thanks @ty-yqs)
• Translation: Updated French (thanks @FRtranslator)
• (iOS) Per-display window settings (zoom, position, keyboard visibility, etc) will be stored in the new registry
• (iOS) Prefer JitStreamer over AltJit when both are available (thanks @ktprograms)
• (macOS) Fixed saving removable drives and shared directories for Apple VMs
• (macOS) Fixed missing audio entitlements (macOS UTM 4 app does not have audio-device entitlement #4342)
• (macOS) Fixed QEMULauncher process not terminating when a VM is force quit
• (macOS) Fixed issue selecting text in SwiftTerm (UTM v4: Text selection in built-in terminal is broken #4297)

Changes (v4.0.1)

• Fixed an issue where an UEFI BIOS error was reported when the target does not use UEFI (Cannot create new PPC VM #4265)
• Added Elementary OS icon (thanks @Unbinilium)
• Updated ja localization (thanks @MMP0)
• Updated fr localization (thanks @FRtranslator)
• Changed the icon for "Serial" so it appears on iOS 14 and macOS 11 as well
• Fixed custom icon not showing up for "legacy" configurations
• Fixed an error trying to migrate "legacy" configuration when "Images" does not exist (4.0.0 beta: Failed to migrate configuration from a previous UTM version #4266)
• Fixed USB redirection (USB devices not working #4263)
• (iOS) Fixed a toolbar issue where USB button overflowed on screen.
• (iOS) Fixed resume button not appearing on < iOS 16
• (iOS) Attempt to close the download progress pop-up after download completes (Download context popover shown during download fails to close after download completes #4261)
• (iOS) "Open" popover refuses to show up again after swiping down (Open UTM option not working after closing it #4260)
• (iOS) Hide "Add" text on iOS 14 settings
• (iOS) Fixed crash on iOS 14 settings when attempting to use the picker (4.0.0 beta: changing the Arch/System/GPU causes a crash #4270)
• (iOS) Fixed an issue on iOS 14 where picker selection was being reset
• (iOS) Fixed an issue where the USB icon is stuck on busy after a device disconnects
• (macOS) Fixed a crash trying to change shared directory for Apple VM (Debian crashes on virtio tag read #4271)
• (macOS) Wizard created invalid target configuration for virtualized targets (Unable to power on virtual machine #4274)

Changes (v4.0.0)

• USB redirection support in terminal mode
• Configuration file format changed, newly saved VMs will not be compatible with older versions of UTM
• Newly imported disk images will be converted to QCOW2 automatically
• Settings: new layout with support for multiple {Display, Serial, Network, Sound} devices (Multiple network interfaces #3585)
• Support multiple displays (Support external monitor #220)
• Added Japanese localization (thanks @MMP0)
• Support adding PTTY (macOS only), TCP client, and TCP server serial connections for QEMU machines (address should show up in the home screen) (PTY interface for QEMU backend #3546)
• Support headless display (remove all displays and built-in serial ports in the settings) ([MacOS] Start VM Headless/In Background #2280)
• Support redirecting QEMU monitor and GDB stub to a serial port
• Support zstd compression for QCOW2 images and use zstd as default for image compression (Support zstd compression #4211)
• Update ANGLE (GL backend) to latest git commit
• Added French localization (thanks @FRtranslator)
• Fixed microphone recording silence (Microphone not working #219)
• Fixed a crash when attempting to delete a QEMU additional argument
• Option in VM settings to use virtfs/9pfs for file sharing (Enable virtfs on macOS host #2184)
• Option in VM settings to change VGA RAM size (Support setting VRAM size for VGA adapter #4034)
• Option in VM settings to enable virtio-balloon driver (Support virtio-balloon  #4136)
• Invert mouse scrolling is now a global setting rather than a per-vm configuration option
• (iOS) Replaced hterm.js with SwiftTerm for terminal mode (Use SwiftTerm for QEMU backend #3473)
• (iOS) Attach to JitStreamer (set IP address in Settings app and UTM will try to connect automatically on launch) (thanks @ktprograms)
• (iOS) Automatically resize the display to fit the screen when the resolution changes if the resize toolbar option is used
• (iOS) Reimplemented the USB and Drives menu with a better UI
• (iOS) On iPadOS 16, show the menu bar when holding Cmd on the keyboard. On previous versions, an on-screen help will show supported commands
• (iOS) Improved audio handling including: output when on silence, mixing with other apps, working when both recording and outputting (including with another app) (iOS: audio recording is stopped when switching to UTM #3996)
• (iOS) Added a global setting to always prefer the built-in microphone to a bluetooth microphone
• (macOS) Fixed running from shortcut in Apple VMs (no longer need to re-import after each launch)
• (macOS) Improved IPSW selection interface and support drag and drop (thanks @pointum)
• (macOS) Fixed running unsigned builds
• (macOS) Removed some deprecated global settings
• (macOS) Fixed an error when trying to download an IPSW and the Caches directory does not exist (thanks @LostInCompilation)
• (macOS) Fixed an issue where a VM could be started twice if the home screen's toolbar is used leading to data corruption (Main window's stop button doesn't stop QEMULauncher, causing data corruption if the same VM is launched again #4166)
• (macOS 13+) Boot into recoveryOS (to disable SIP, etc) by right clicking on the VM and selecting "Run in recovery..." (Support booting into recovery mode / 1TR? #3526)
• (macOS 13+) Option in VM settings to enable Rosetta for x86_64 emulation (Running Intel Binaries in Linux VMs with Rosetta #4100)
• (macOS 13+) Option in VM settings to enable clipboard sharing (SPICE support needed on the guest) (Allow shared clipboard in GUI Linux Apple VMs on macOS 13 #4121)
• (macOS 13+) GUI display for Linux VMs (Allow running GUI Linux in Apple VMs (on macOS 13) #4120)
• (macOS 13+) Add removable drives, will show up as USB mass storage

Issues

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

Known Issues

• Automation URL commands currently do not work completely
• (macOS) GUI Linux boot may not be compatible with all distros. Ubuntu Server 22.04 does not install.

Installation

iOS: Visit https://getutm.app/install/ for the most up to date installation instructions.
macOS: Download "UTM.dmg" below and copy the contents to your /Applications directory.

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	No	Yes(1)	Yes
UTM.SE.ipa	Non-jailbroken iOS version (sideloading)	AltStore, enterprise signing, etc	No	No	No

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

---

This discussion was created from the release v4.0.6 (RC).

[conath]

I have a concern regarding the link from UTM wizard to uupdump . net – it is a third party service that itself is dependent on Microsoft. This creates friction: for example, the latest scripts for creating the ISO currently don't work on macOS:

Windows 11, version 22H2 or later
This build requires using Windows 10, version 2004 or later for the ISO to be properly created. Scripts for other platforms will output a broken ISO.

I suggest that the VM wizard should link to a UTM-controlled website instead, which contains additional information and links to multiple solutions for obtaining a Windows ISO. The label should also contain a link arrow, to indicate it will open a browser window. (
#4443)

[osy]

That’s a good idea, can you post this as an issue?

[conath]

#4445

[Peter1234567899]

I have an issue, when I running the UTM on my M1 iPad Pro with iPadOS 14.8.1
Which was installed by TrollInstaller2. It just stuck, and it says "Start boot option" even when I tap the "Enter" button many times.(btw I'm trying to run Windows11)