v4.0.4 (Beta)

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 and it has only been tested on iOS 15.

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.

Changes (v4.0.4)

• Fixed in issue generating configuration for IDE drives leading to PPC not booting and I/O errors on PC (#4372, #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 (#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 (#4390)
• (iOS) Fixed a regression which caused the cursor to not be captured (#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 (#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 (#4377)
• (macOS) Fixed some settings layout issue on < macOS 13 (#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 (#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 (#4364)
• Added support for more than 2 IDE drives in PC emulation
• Restored the setting to turn off blinking cursor (#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 (#4325)
• (iOS) Fixed an issue where the file importer was not opening (#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 (#4351)
• (macOS) Fixed an issue where restarting a VM results in duplicate windows (#4367)
• (macOS) Save the size of terminal windows (#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 (#4277)
• Fixed incorrect parsing of CPU flags (#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 (#4342)
• (macOS) Fixed QEMULauncher process not terminating when a VM is force quit
• (macOS) Fixed issue selecting text in SwiftTerm (#4297)

Changes (v4.0.1)

• Fixed an issue where an UEFI BIOS error was reported when the target does not use UEFI (#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 (#4266)
• Fixed USB redirection (#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 (#4261)
• (iOS) "Open" popover refuses to show up again after swiping down (#4260)
• (iOS) Hide "Add" text on iOS 14 settings
• (iOS) Fixed crash on iOS 14 settings when attempting to use the picker (#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 (#4271)
• (macOS) Wizard created invalid target configuration for virtualized targets (#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 (#3585)
• Support multiple displays (#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) (#3546)
• Support headless display (remove all displays and built-in serial ports in the settings) (#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 (#4211)
• Update ANGLE (GL backend) to latest git commit
• Added French localization (thanks @FRtranslator)
• Fixed microphone recording silence (...

v4.0.3 (Beta)

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

Installation

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

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.
• Virtiofs 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.

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.

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 VirtioFS 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 (#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 (#4364)
• Added support for more than 2 IDE drives in PC emulation
• Restored the setting to turn off blinking cursor (#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 (#4325)
• (iOS) Fixed an issue where the file importer was not opening (#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 (#4351)
• (macOS) Fixed an issue where restarting a VM results in duplicate windows (#4367)
• (macOS) Save the size of terminal windows (#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.
• Virtiofs no longer requires SPICE to be enabled (thanks @tie)
• Fixed an issue with PPC VMs not showing 256 colours correctly (#4277)
• Fixed incorrect parsing of CPU flags (#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 (#4342)
• (macOS) Fixed QEMULauncher process not terminating when a VM is force quit
• (macOS) Fixed issue selecting text in SwiftTerm (#4297)

Changes (v4.0.1)

• Fixed an issue where an UEFI BIOS error was reported when the target does not use UEFI (#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 (#4266)
• Fixed USB redirection (#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 (#4261)
• (iOS) "Open" popover refuses to show up again after swiping down (#4260)
• (iOS) Hide "Add" text on iOS 14 settings
• (iOS) Fixed crash on iOS 14 settings when attempting to use the picker (#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 (#4271)
• (macOS) Wizard created invalid target configuration for virtualized targets (#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 (#3585)
• Support multiple displays (#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) (#3546)
• Support headless display (remove all displays and built-in serial ports in the settings) (#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 (#4211)
• Update ANGLE (GL backend) to latest git commit
• Added French localization (thanks @FRtranslator)
• Fixed microphone recording silence (#219)
• Fixed a crash when attempting to delete a QEMU additional argument
• Option in VM settings to use virtfs/9pfs for file sharing (#2184)
• Option in VM settings to change VGA RAM size (#4034)
• Option in VM settings to enable virtio-balloon driver (#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 (#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) (#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 (#4166)
• (macOS 13+) Boot into recoveryOS (to disable SIP, etc) by right clickin...

v4.0.2 (Beta)

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

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.

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.
• Virtiofs 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.

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.

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.
• Virtiofs no longer requires SPICE to be enabled (thanks @tie)
• Fixed an issue with PPC VMs not showing 256 colours correctly (#4277)
• Fixed incorrect parsing of CPU flags (#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 (#4342)
• (macOS) Fixed QEMULauncher process not terminating when a VM is force quit
• (macOS) Fixed issue selecting text in SwiftTerm (#4297)

Changes (v4.0.1)

• Fixed an issue where an UEFI BIOS error was reported when the target does not use UEFI (#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 (#4266)
• Fixed USB redirection (#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 (#4261)
• (iOS) "Open" popover refuses to show up again after swiping down (#4260)
• (iOS) Hide "Add" text on iOS 14 settings
• (iOS) Fixed crash on iOS 14 settings when attempting to use the picker (#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 (#4271)
• (macOS) Wizard created invalid target configuration for virtualized targets (#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 (#3585)
• Support multiple displays (#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) (#3546)
• Support headless display (remove all displays and built-in serial ports in the settings) (#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 (#4211)
• Update ANGLE (GL backend) to latest git commit
• Added French localization (thanks @FRtranslator)
• Fixed microphone recording silence (#219)
• Fixed a crash when attempting to delete a QEMU additional argument
• Option in VM settings to use virtfs/9pfs for file sharing (#2184)
• Option in VM settings to change VGA RAM size (#4034)
• Option in VM settings to enable virtio-balloon driver (#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 (#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) (#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 (#4166)
• (macOS 13+) Boot into recoveryOS (to disable SIP, etc) by right clicking on the VM and selecting "Run in recovery..." (#3526)
• (macOS 13+) Option in VM settings to enable Rosetta for x86_64 emulation (#4100)
• (macOS 13+) Option in VM settings to enable clipboard sharing (SPICE support needed on the guest) (#4121)
• (macOS 13+) GUI display for Linux VMs (#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.
• (macOS) You cannot reopen a window for additional displays after you close them

v4.0.1 (Beta)

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

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.

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.
• Virtiofs 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.

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.

Changes (v4.0.1)

• Fixed an issue where an UEFI BIOS error was reported when the target does not use UEFI (#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 (#4266)
• Fixed USB redirection (#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 (#4261)
• (iOS) "Open" popover refuses to show up again after swiping down (#4260)
• (iOS) Hide "Add" text on iOS 14 settings
• (iOS) Fixed crash on iOS 14 settings when attempting to use the picker (#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 (#4271)
• (macOS) Wizard created invalid target configuration for virtualized targets (#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 (#3585)
• Support multiple displays (#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) (#3546)
• Support headless display (remove all displays and built-in serial ports in the settings) (#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 (#4211)
• Update ANGLE (GL backend) to latest git commit
• Added French localization (thanks @FRtranslator)
• Fixed microphone recording silence (#219)
• Fixed a crash when attempting to delete a QEMU additional argument
• Option in VM settings to use virtfs/9pfs for file sharing (#2184)
• Option in VM settings to change VGA RAM size (#4034)
• Option in VM settings to enable virtio-balloon driver (#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 (#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) (#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 (#4166)
• (macOS 13+) Boot into recoveryOS (to disable SIP, etc) by right clicking on the VM and selecting "Run in recovery..." (#3526)
• (macOS 13+) Option in VM settings to enable Rosetta for x86_64 emulation (#4100)
• (macOS 13+) Option in VM settings to enable clipboard sharing (SPICE support needed on the guest) (#4121)
• (macOS 13+) GUI display for Linux VMs (#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
• Removable drive saving and configuration are not completely working for Apple VMs
• (iOS) VM display state (zoom level, keyboard show/hide, etc) are not saved
• (macOS) GUI Linux boot may not be compatible with all distros. Ubuntu Server 22.04 does not install.
• (macOS) You cannot reopen a window for additional displays after you close them

v4.0.0 (Beta)

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

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.

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.
• Virtiofs 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 follow a different format than Linux so you may need to set up your guest to have permission to access the shared directory.

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 and the new configuration format will not work on older versions of UTM. Please backup all VMs prior to updating as you will not be able to re-open them after using UTM v4.

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 (#3585)
• Support multiple displays (#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) (#3546)
• Support headless display (remove all displays and built-in serial ports in the settings) (#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 (#4211)
• Update ANGLE (GL backend) to latest git commit
• Added French localization (thanks @FRtranslator)
• Fixed microphone recording silence (#219)
• Fixed a crash when attempting to delete a QEMU additional argument
• Option in VM settings to use virtfs/9pfs for file sharing (#2184)
• Option in VM settings to change VGA RAM size (#4034)
• Option in VM settings to enable virtio-balloon driver (#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 (#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) (#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 (#4166)
• (macOS 13+) Boot into recoveryOS (to disable SIP, etc) by right clicking on the VM and selecting "Run in recovery..." (#3526)
• (macOS 13+) Option in VM settings to enable Rosetta for x86_64 emulation (#4100)
• (macOS 13+) Option in VM settings to enable clipboard sharing (SPICE support needed on the guest) (#4121)
• (macOS 13+) GUI display for Linux VMs (#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
• Removable drive saving and configuration are not completely working for Apple VMs
• (iOS) VM display state (zoom level, keyboard show/hide, etc) are not saved
• (macOS) GUI Linux boot may not be compatible with all distros. Ubuntu Server 22.04 does not install.
• (macOS) You cannot reopen a window for additional displays after you close them

v3.2.4

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.

Highlights

• QEMU 7.0.0: The backend has been updated to the latest release. Check out https://www.qemu.org/2022/04/19/qemu-7-0-0/ for more details. Additionally, other backend components such as SPICE GTK, libusbredir, and more have also been updated.
• Reclaiming space: the host will attempt to TRIM any page of all zeros when committed to the QCOW2 disk image. Additionally, a new button in disk settings will allow you to re-convert a disk image to reclaim space (of all-zero pages) as well as compress an existing disk image (macOS 12+ only). Note compression is only done statically which means when the guest modifies a sector, it will be stored uncompressed just like before.
• Disposable mode: right click/long press on a QEMU VM and select "Run without saving changes" to start VM in "disposable mode." In this mode, changes will not be saved to disk and will be discarded once the VM is stopped. (thanks @ktprograms)

Notes

• Reminder: for troubleshooting common Windows install issues (such as no networking), please check out the guide or this guide for Ubuntu install issues.
• If you manually added highmem=on or highmem=off to your QEMU Machine Properties as a workaround to issues in a previous release, please remove it.
• (iOS) UTM v3.2.x will be the last update to support iOS 11-13. If you are still running those versions, please make sure you report any issues now so they can be fixed by the final release of v3.2.x. After that, iOS 14+ will be required to run future versions of UTM.

Changes (v3.2.4)

• Fixed isolated network mode with new vmnet backend (#4022)
• Fixed some USB devices not showing up for USB capture (#3975)
• (iOS) Added tap to click with Apple Pencil (thanks @luken11)
• (macOS) Workaround a SwiftUI freeze then crash in the home view when the scrollbar is visible (#3612)
• (macOS) Fixed an error loading Apple Virtualization VMs after updating from macOS 11 to macOS 12 (#4023)
• (macOS) Fixed secondary click using Control+Click on the VM list (#4018)

Changes (v3.2.3)

• Disabled screenshots for GL virtual machines (workaround for a crash that occurs, this will be re-enabled in a future update once the crash is triaged)
• (iOS) Pass through Esc key on external keyboard when VoiceOver is in use (#3940)
• (macOS) Use correct scaling when HiDPI is enabled (#3968)
• (macOS) Fix toolbar overlapping top of screen when "Automatically hide and show the menu bar in full screen" is unchecked in system preferences (#3919)
• (macOS) When bridged networking is selected, default the interface to "en0" (#3945)
• (macOS) Wizard: clarify that Linux kernel and initrd must be uncompressed if Apple Virtualization is used

Changes (v3.2.2)

• Add "disposable mode" (see highlights for more information) (thanks @ktprograms)
• Do not enable UEFI for unsupported architectures (#3976)
• Fix broken play button in sidebar (#3980)
• Fix "Error -1 while loading VM state" on resume caused by usbredir (#3979)
• Various UI tweaks and typo fixes (#3984)
• Fixed pausing without saving state
• Fixed showing warning prompt when VM is paused but not saved
• (iOS) Detect if UTM is installed without AltStore and AltJIT will not attempt to be used.
• (iOS) Reduced build size by 10% (thanks @Halo-Michael) (#3934)
• (macOS) Add new preference option to revert Caps Lock behaviour to pre 3.2.0 (#3974)

Changes (v3.2.1)

• Fixed boot of RISC-V virt platform (thanks @wegank)
• Remove highmem=off default property which is no longer needed on macOS 12.4+ and iOS 15.5+ (it will still be used on lower versions) (#3941, #3946)
• Caps lock state will now be synchronized when mouse is captured (note that if mouse is captured before the guest OS has booted up, the state will be out of sync) (#3415)
• Re-introduce option to disable auto-resolution when SPICE tools is installed (#3938)
• When discarding unsaved settings, do not delete any disk image not created by UTM (#3587)
• Fix downloading of UTM zip files when the URL does not end in ".zip" (#3953)
• (macOS) When importing a disk image, do not silently overwrite an existing image of the same name (#3866)
• (macOS) Added option to reclaim unused space from disk image and to compress a disk image (macOS 12+ only)
• (macOS) On the VM list, the start button will now change to a spinner when the VM is starting and will disappear when the VM has started. Also added the ability to start/show a VM by double-clicking on the list item (#3885)

Changes (v3.2.0)

• Checkbox for "Import VHDX Image" in the wizard now works correctly again (#3760)
• Fixed various crashes in SPICE webdavd share has been resolved thanks to updated backend (#3633)
• Removed "cache=writethrough" argument from block devices since it was added to workaround an issue with VHDX images which we now convert to QCOW2
• Added "discard=unmap,detect-zeroes=unmap" argument to block devices to reclaim unused space (#3460)
• When "do not save screenshot to disk" is enabled, any existing screenshot will be deleted the next time the VM is started (#3936)
• Fixed an issue in QEMU additional arguments where it sometimes would not appear after setting it (#3895)
• Fixed RNG device not appearing in console mode even when enabled in the settings (#3790)
• Added support for up to 5 additional mouse buttons (you may need to re-map them in the guest OS as they are automatically set to middle/up/down/side/extra) (#3906)
• (iOS) Fixed an issue in the legacy view where "invalid identifier" error may show up on a newly created VM (#3872)
• (macOS) Fixed crash when changing display settings while the VM window is open (but stopped) (#3925)
• (macOS) Fixed crash when trying to select "Share..." in context menu (#3915)
• (macOS) Prevent allowing rapid clicking of pause/resume which may lead to VM corruption (#3629)
• (macOS) Show progress indicator while VM is saving to prevent user from terminating the app early and cause corruption (#3752)
• (macOS) Block unsupported Apple USB devices from being captured (#3759)

Issues

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

Known Issues

• iOS 14 and below: There is a known issue crashing while running under taurine but not unc0ver. (#3628)

v3.2.3

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.

Highlights

• QEMU 7.0.0: The backend has been updated to the latest release. Check out https://www.qemu.org/2022/04/19/qemu-7-0-0/ for more details. Additionally, other backend components such as SPICE GTK, libusbredir, and more have also been updated.
• Reclaiming space: the host will attempt to TRIM any page of all zeros when committed to the QCOW2 disk image. Additionally, a new button in disk settings will allow you to re-convert a disk image to reclaim space (of all-zero pages) as well as compress an existing disk image (macOS 12+ only). Note compression is only done statically which means when the guest modifies a sector, it will be stored uncompressed just like before.
• Disposable mode: right click/long press on a QEMU VM and select "Run without saving changes" to start VM in "disposable mode." In this mode, changes will not be saved to disk and will be discarded once the VM is stopped. (thanks @ktprograms)

Notes

• Reminder: for troubleshooting common Windows install issues (such as no networking), please check out the guide.
• If you manually added highmem=on or highmem=off to your QEMU Machine Properties as a workaround to issues in a previous release, please remove it.
• (iOS) UTM v3.2.x will be the last update to support iOS 11-13. If you are still running those versions, please make sure you report any issues now so they can be fixed by the final release of v3.2.x. After that, iOS 14+ will be required to run future versions of UTM.

Changes (v3.2.3)

• Disabled screenshots for GL virtual machines (workaround for a crash that occurs, this will be re-enabled in a future update once the crash is triaged)
• (iOS) Pass through Esc key on external keyboard when VoiceOver is in use (#3940)
• (macOS) Use correct scaling when HiDPI is enabled (#3968)
• (macOS) Fix toolbar overlapping top of screen when "Automatically hide and show the menu bar in full screen" is unchecked in system preferences (#3919)
• (macOS) When bridged networking is selected, default the interface to "en0" (#3945)
• (macOS) Wizard: clarify that Linux kernel and initrd must be uncompressed if Apple Virtualization is used

Changes (v3.2.2)

• Add "disposable mode" (see highlights for more information) (thanks @ktprograms)
• Do not enable UEFI for unsupported architectures (#3976)
• Fix broken play button in sidebar (#3980)
• Fix "Error -1 while loading VM state" on resume caused by usbredir (#3979)
• Various UI tweaks and typo fixes (#3984)
• Fixed pausing without saving state
• Fixed showing warning prompt when VM is paused but not saved
• (iOS) Detect if UTM is installed without AltStore and AltJIT will not attempt to be used.
• (iOS) Reduced build size by 10% (thanks @Halo-Michael) (#3934)
• (macOS) Add new preference option to revert Caps Lock behaviour to pre 3.2.0 (#3974)

Changes (v3.2.1)

• Fixed boot of RISC-V virt platform (thanks @wegank)
• Remove highmem=off default property which is no longer needed on macOS 12.4+ and iOS 15.5+ (it will still be used on lower versions) (#3941, #3946)
• Caps lock state will now be synchronized when mouse is captured (note that if mouse is captured before the guest OS has booted up, the state will be out of sync) (#3415)
• Re-introduce option to disable auto-resolution when SPICE tools is installed (#3938)
• When discarding unsaved settings, do not delete any disk image not created by UTM (#3587)
• Fix downloading of UTM zip files when the URL does not end in ".zip" (#3953)
• (macOS) When importing a disk image, do not silently overwrite an existing image of the same name (#3866)
• (macOS) Added option to reclaim unused space from disk image and to compress a disk image (macOS 12+ only)
• (macOS) On the VM list, the start button will now change to a spinner when the VM is starting and will disappear when the VM has started. Also added the ability to start/show a VM by double-clicking on the list item (#3885)

Changes (v3.2.0)

• Checkbox for "Import VHDX Image" in the wizard now works correctly again (#3760)
• Fixed various crashes in SPICE webdavd share has been resolved thanks to updated backend (#3633)
• Removed "cache=writethrough" argument from block devices since it was added to workaround an issue with VHDX images which we now convert to QCOW2
• Added "discard=unmap,detect-zeroes=unmap" argument to block devices to reclaim unused space (#3460)
• When "do not save screenshot to disk" is enabled, any existing screenshot will be deleted the next time the VM is started (#3936)
• Fixed an issue in QEMU additional arguments where it sometimes would not appear after setting it (#3895)
• Fixed RNG device not appearing in console mode even when enabled in the settings (#3790)
• Added support for up to 5 additional mouse buttons (you may need to re-map them in the guest OS as they are automatically set to middle/up/down/side/extra) (#3906)
• (iOS) Fixed an issue in the legacy view where "invalid identifier" error may show up on a newly created VM (#3872)
• (macOS) Fixed crash when changing display settings while the VM window is open (but stopped) (#3925)
• (macOS) Fixed crash when trying to select "Share..." in context menu (#3915)
• (macOS) Prevent allowing rapid clicking of pause/resume which may lead to VM corruption (#3629)
• (macOS) Show progress indicator while VM is saving to prevent user from terminating the app early and cause corruption (#3752)
• (macOS) Block unsupported Apple USB devices from being captured (#3759)

Issues

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

Known Issues

• iOS 14 and below: There is a known issue crashing while running under taurine but not unc0ver. (#3628)

v3.2.2 (Beta)

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.

Highlights

• QEMU 7.0.0: The backend has been updated to the latest release. Check out https://www.qemu.org/2022/04/19/qemu-7-0-0/ for more details. Additionally, other backend components such as SPICE GTK, libusbredir, and more have also been updated.
• Reclaiming space: the host will attempt to TRIM any page of all zeros when committed to the QCOW2 disk image. Additionally, a new button in disk settings will allow you to re-convert a disk image to reclaim space (of all-zero pages) as well as compress an existing disk image (macOS 12+ only). Note compression is only done statically which means when the guest modifies a sector, it will be stored uncompressed just like before.
• Disposable mode: right click/long press on a QEMU VM and select "Run without saving changes" to start VM in "disposable mode." In this mode, changes will not be saved to disk and will be discarded once the VM is stopped. (thanks @ktprograms)

Notes

• (iOS) UTM v3.2.x will be the last update to support iOS 11-13. If you are still running those versions, please make sure you report any issues now so they can be fixed by the final release of v3.2.x. After that, iOS 14+ will be required to run future versions of UTM.
• In v3.2.0, if you added highmem=on to your QEMU Machine Properties as a workaround, please remove it after updating. If you did not use v3.2.0, you can ignore this.

Changes (v3.2.2)

• Add "disposable mode" (see highlights for more information) (thanks @ktprograms)
• Do not enable UEFI for unsupported architectures (#3976)
• Fix broken play button in sidebar (#3980)
• Fix "Error -1 while loading VM state" on resume caused by usbredir (#3979)
• Various UI tweaks and typo fixes (#3984)
• Fixed pausing without saving state
• Fixed showing warning prompt when VM is paused but not saved
• (iOS) Detect if UTM is installed without AltStore and AltJIT will not attempt to be used.
• (iOS) Reduced build size by 10% (thanks @Halo-Michael) (#3934)
• (macOS) Add new preference option to revert Caps Lock behaviour to pre 3.2.0 (#3974)

Changes (v3.2.1)

• Fixed boot of RISC-V virt platform (thanks @wegank)
• Remove highmem=off default property which is no longer needed on macOS 12.4+ and iOS 15.5+ (it will still be used on lower versions) (#3941, #3946)
• Caps lock state will now be synchronized when mouse is captured (note that if mouse is captured before the guest OS has booted up, the state will be out of sync) (#3415)
• Re-introduce option to disable auto-resolution when SPICE tools is installed (#3938)
• When discarding unsaved settings, do not delete any disk image not created by UTM (#3587)
• Fix downloading of UTM zip files when the URL does not end in ".zip" (#3953)
• (macOS) When importing a disk image, do not silently overwrite an existing image of the same name (#3866)
• (macOS) Added option to reclaim unused space from disk image and to compress a disk image (macOS 12+ only)
• (macOS) On the VM list, the start button will now change to a spinner when the VM is starting and will disappear when the VM has started. Also added the ability to start/show a VM by double-clicking on the list item (#3885)

Changes (v3.2.0)

• Checkbox for "Import VHDX Image" in the wizard now works correctly again (#3760)
• Fixed various crashes in SPICE webdavd share has been resolved thanks to updated backend (#3633)
• Removed "cache=writethrough" argument from block devices since it was added to workaround an issue with VHDX images which we now convert to QCOW2
• Added "discard=unmap,detect-zeroes=unmap" argument to block devices to reclaim unused space (#3460)
• When "do not save screenshot to disk" is enabled, any existing screenshot will be deleted the next time the VM is started (#3936)
• Fixed an issue in QEMU additional arguments where it sometimes would not appear after setting it (#3895)
• Fixed RNG device not appearing in console mode even when enabled in the settings (#3790)
• Added support for up to 5 additional mouse buttons (you may need to re-map them in the guest OS as they are automatically set to middle/up/down/side/extra) (#3906)
• (iOS) Fixed an issue in the legacy view where "invalid identifier" error may show up on a newly created VM (#3872)
• (macOS) Fixed crash when changing display settings while the VM window is open (but stopped) (#3925)
• (macOS) Fixed crash when trying to select "Share..." in context menu (#3915)
• (macOS) Prevent allowing rapid clicking of pause/resume which may lead to VM corruption (#3629)
• (macOS) Show progress indicator while VM is saving to prevent user from terminating the app early and cause corruption (#3752)
• (macOS) Block unsupported Apple USB devices from being captured (#3759)

Issues

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

Known Issues

• iOS 14 and below: There is a known issue crashing while running under taurine but not unc0ver. (#3628)

v3.2.1 (Beta)

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.

Highlights

• QEMU 7.0.0: The backend has been updated to the latest release. Check out https://www.qemu.org/2022/04/19/qemu-7-0-0/ for more details. Additionally, other backend components such as SPICE GTK, libusbredir, and more have also been updated.
• Reclaiming space: the host will attempt to TRIM any page of all zeros when committed to the QCOW2 disk image. Additionally, a new button in disk settings will allow you to re-convert a disk image to reclaim space (of all-zero pages) as well as compress an existing disk image (macOS 12+ only). Note compression is only done statically which means when the guest modifies a sector, it will be stored uncompressed just like before.

Notes

• (iOS) UTM v3.2.x will be the last update to support iOS 11-13. If you are still running those versions, please make sure you report any issues now so they can be fixed by the final release of v3.2.x. After that, iOS 14+ will be required to run future versions of UTM.
• In v3.2.0, if you added highmem=on to your QEMU Machine Properties as a workaround, please remove it after updating. If you did not use v3.2.0, you can ignore this.

Changes (v3.2.1)

• Fixed boot of RISC-V virt platform (thanks @wegank)
• Remove highmem=off default property which is no longer needed on macOS 12.4+ and iOS 15.5+ (it will still be used on lower versions) (#3941, #3946)
• Caps lock state will now be synchronized when mouse is captured (note that if mouse is captured before the guest OS has booted up, the state will be out of sync) (#3415)
• Re-introduce option to disable auto-resolution when SPICE tools is installed (#3938)
• When discarding unsaved settings, do not delete any disk image not created by UTM (#3587)
• Fix downloading of UTM zip files when the URL does not end in ".zip" (#3953)
• (macOS) When importing a disk image, do not silently overwrite an existing image of the same name (#3866)
• (macOS) Added option to reclaim unused space from disk image and to compress a disk image (macOS 12+ only)
• (macOS) On the VM list, the start button will now change to a spinner when the VM is starting and will disappear when the VM has started. Also added the ability to start/show a VM by double-clicking on the list item (#3885)

Changes (v3.2.0)

• Checkbox for "Import VHDX Image" in the wizard now works correctly again (#3760)
• Fixed various crashes in SPICE webdavd share has been resolved thanks to updated backend (#3633)
• Removed "cache=writethrough" argument from block devices since it was added to workaround an issue with VHDX images which we now convert to QCOW2
• Added "discard=unmap,detect-zeroes=unmap" argument to block devices to reclaim unused space (#3460)
• When "do not save screenshot to disk" is enabled, any existing screenshot will be deleted the next time the VM is started (#3936)
• Fixed an issue in QEMU additional arguments where it sometimes would not appear after setting it (#3895)
• Fixed RNG device not appearing in console mode even when enabled in the settings (#3790)
• Added support for up to 5 additional mouse buttons (you may need to re-map them in the guest OS as they are automatically set to middle/up/down/side/extra) (#3906)
• (iOS) Fixed an issue in the legacy view where "invalid identifier" error may show up on a newly created VM (#3872)
• (macOS) Fixed crash when changing display settings while the VM window is open (but stopped) (#3925)
• (macOS) Fixed crash when trying to select "Share..." in context menu (#3915)
• (macOS) Prevent allowing rapid clicking of pause/resume which may lead to VM corruption (#3629)
• (macOS) Show progress indicator while VM is saving to prevent user from terminating the app early and cause corruption (#3752)
• (macOS) Block unsupported Apple USB devices from being captured (#3759)

Issues

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

Known Issues

• iOS 14 and below: There is a known issue crashing while running under taurine but not unc0ver. (#3628)

v3.2.0 (Beta)

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.

Highlights

• QEMU 7.0.0*: The backend has been updated to the latest release. Check out https://www.qemu.org/2022/04/19/qemu-7-0-0/ for more details. Additionally, other backend components such as SPICE GTK, libusbredir, and more have also been updated.

Notes

• (iOS) UTM v3.2.x will be the last update to support iOS 11-13. If you are still running those versions, please make sure you report any issues now so they can be fixed by the final release of v3.2.x. After that, iOS 14+ will be required to run future versions of UTM.

Changes (v3.2.0)

• Checkbox for "Import VHDX Image" in the wizard now works correctly again (#3760)
• Fixed various crashes in SPICE webdavd share has been resolved thanks to updated backend (#3633)
• Removed "cache=writethrough" argument from block devices since it was added to workaround an issue with VHDX images which we now convert to QCOW2
• Added "discard=unmap,detect-zeroes=unmap" argument to block devices to reclaim unused space (#3460)
• When "do not save screenshot to disk" is enabled, any existing screenshot will be deleted the next time the VM is started (#3936)
• Fixed an issue in QEMU additional arguments where it sometimes would not appear after setting it (#3895)
• Fixed RNG device not appearing in console mode even when enabled in the settings (#3790)
• Added support for up to 5 additional mouse buttons (you may need to re-map them in the guest OS as they are automatically set to middle/up/down/side/extra) (#3906)
• (iOS) Fixed an issue in the legacy view where "invalid identifier" error may show up on a newly created VM (#3872)
• (macOS) Fixed crash when changing display settings while the VM window is open (but stopped) (#3925)
• (macOS) Fixed crash when trying to select "Share..." in context menu (#3915)
• (macOS) Prevent allowing rapid clicking of pause/resume which may lead to VM corruption (#3629)
• (macOS) Show progress indicator while VM is saving to prevent user from terminating the app early and cause corruption (#3752)
• (macOS) Block unsupported Apple USB devices from being captured (#3759)

Issues

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

Known Issues

• iOS 14 and below: There is a known issue crashing while running under taurine but not unc0ver. (#3628)
• Starting a VM shows an empty "Error" dialog. This will be fixed in the next release. A workaround is to add highmem=on to "QEMU -> QEMU Machine Properties".