v2.0.21

Installation

Visit https://getutm.app/install/ for the most up to date installation instructions.

Changes

• Updated zh-Hans translation
• (iOS) Check for iOS 14.4 and show warning message
• (macOS) Disabled multiple windows and tabs for the home view
• (macOS) Added menu commands for Import and New
• (macOS) Fixed an issue where opening a .utm file creates a new window

Notice for iOS 14.4+

iOS 14.4 broke JIT again (for non-jailbroken A12+ devices), and likely for good this time. We do not recommend updating to iOS 14.4 or higher. Future support for iOS will be limited to tethered and jailbroken devices only.

Known Issues

• Black screen or crash trying to start any VM? Make sure you read all the instructions in the install page.
• When installed via Cydia/Sileo, Settings and Files integration does not work and VMs are not deleted automatically when uninstalled.

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

v2.0.20

Installation

Visit https://getutm.app/install/ for the most up to date installation instructions.

Changes

• Fixed CPU and core settings not used (#2293)
• Fixed a bug where VM sometimes boots up in a black screen and requires resizing to see the graphics
• Fixed a crash when starting VM in console mode with sharing enabled (#2291)
• Moved default share from /tmp/Public to Documents/Public. This is the Documents folder in UTM's sandbox, not the user's documents directory.
• Disabled sharing options and show warning message when console mode is enabled
• No more white background behind the console (#1201)
• (macOS) Enhanced UI for setting CPU flags
• (macOS) Detect when SPICE agent is installed and allow resolution change by resizing the VM window
• (macOS) New settings option to right click with Control+click (#2287)

Notice for iOS 14.4

iOS 14.4 broke JIT again (for non-jailbroken A12+ devices), and likely for good this time. We do not recommend updating to iOS 14.4. Future support for iOS will be limited to jailbroken devices only.

macOS Sandbox Migration

If you are updating from < 2.0.17 on macOS, then when you open UTM you will not see any VMs you previously created! To fix this, move your .utm files from ~/Documents to ~/Library/Containers/com.utmapp.UTM/Data/Documents. You can do it in Terminal with the following command:

mv ~/Documents/*.utm ~/Library/Containers/com.utmapp.UTM/Data/Documents

or with Finder

1. Open Finder and go to your home directory.
2. Press Cmd+Shift+. (that's the period key) to show hidden files.
3. Browse to Library -> Containers -> UTM -> Data -> Documents
4. Copy or move your .utm files from your home's Documents directory to this directory.

Known Issues

• Black screen or crash trying to start any VM? Make sure you read all the instructions in the install page.
• Cannot import any drives/ISO: there is a bug in iOS where an invalid "application-identifier" entitlement causes the file picker to not work. A fix for iOS App Signer is submitted and can be manually compiled. If you are using AltStore, you need use a free (not paid) developer account.
• When installed via Cydia/Sileo, Settings and Files integration does not work and VMs are not deleted automatically when uninstalled.

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

v2.0.19

Installation

Visit https://getutm.app/install/ for the most up to date installation instructions.

Changes

• (macOS) Add menu command to unhide sidebar (thanks @laosb)
• (macOS) Redesign removable drives and shared directory UI (thanks @conath)
• (macOS) Fix crash on macOS 11.2 when using JIT
• (iOS) Disable autocorrect in text fields in settings (#2282)
• (iOS) Show animation to home screen when exiting (#2279)
• (Both) Toggle MB/GB when creating disk image (default to GB) (#2278)
• (macOS) "Show in Finder" command in VM card's right click context menu (#2277)
• (Both) Better handle orphaned disk images due to crash or discarding settings. Should prevent "file already exists" error when importing a disk image. (#2275)
• (Both) Default x86_64 and i386 target is now q35 (2009) (#2274)
• (Both) Export QEMU command line feature (#2283)
• (Both) New setting: change CPU model and CPU flags when supported by QEMU (#1197)

Notice for upcoming iOS update

iOS 14.4 beta 2 broke JIT again (for non-jailbroken A12+ devices), and likely for good this time. We do not recommend updating to iOS 14.4 when it is released to the public.

macOS Sandbox Migration

If you are updating from < 2.0.17 on macOS, then when you open UTM you will not see any VMs you previously created! To fix this, move your .utm files from ~/Documents to ~/Library/Containers/com.utmapp.UTM/Data/Documents. You can do it in Terminal with the following command:

mv ~/Documents/*.utm ~/Library/Containers/com.utmapp.UTM/Data/Documents

or with Finder

1. Open Finder and go to your home directory.
2. Press Cmd+Shift+. (that's the period key) to show hidden files.
3. Browse to Library -> Containers -> UTM -> Data -> Documents
4. Copy or move your .utm files from your home's Documents directory to this directory.

Known Issues

• Black screen or crash trying to start any VM? Make sure you read all the instructions in the install page.
• Cannot import any drives/ISO: there is a bug in iOS where an invalid "application-identifier" entitlement causes the file picker to not work. A fix for iOS App Signer is submitted and can be manually compiled. If you are using AltStore, you need use a free (not paid) developer account.
• When installed via Cydia/Sileo, Settings and Files integration does not work and VMs are not deleted automatically when uninstalled.

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

v2.0.18

Installation

Visit https://getutm.app/install/ for the most up to date installation instructions.

Changes

• Check out the new UTM Gallery: https://mac.getutm.app/gallery/
• QEMU 5.1.0 changed JIT cache allocation to default to be host RAM / 8 instead of guest RAM / 4 as before. We revert back to guest RAM / 4.
• Fixed "Allocate x bytes for jit buffer: invalid argument" (#2269)
• (macOS) Console mode broken due to CoreAudio API cannot be used after fork() (#2267)
• Skip USB device for "isapc" (#2272)

Notice for upcoming iOS update

iOS 14.4 beta 2 broke JIT again (for non-jailbroken A12+ devices), and likely for good this time. We do not recommend updating to iOS 14.4 when it is released to the public.

macOS Sandbox Migration

If you are updating from < 2.0.17 on macOS, then when you open UTM you will not see any VMs you previously created! To fix this, move your .utm files from ~/Documents to ~/Library/Containers/com.utmapp.UTM/Data/Documents. You can do it in Terminal with the following command:

mv ~/Documents/*.utm ~/Library/Containers/com.utmapp.UTM/Data/Documents

or with Finder

1. Open Finder and go to your home directory.
2. Press Cmd+Shift+. (that's the period key) to show hidden files.
3. Browse to Library -> Containers -> UTM -> Data -> Documents
4. Copy or move your .utm files from your home's Documents directory to this directory.

Known Issues

• Black screen or crash trying to start any VM? Make sure you read all the instructions in the install page.
• Cannot import any drives/ISO: there is a bug in iOS where an invalid "application-identifier" entitlement causes the file picker to not work. A fix for iOS App Signer is submitted and can be manually compiled. If you are using AltStore, you need use a free (not paid) developer account.
• When installed via Cydia/Sileo, Settings and Files integration does not work and VMs are not deleted automatically when uninstalled.

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

v2.0.17

Installation

Visit https://getutm.app/install/ for the most up to date installation instructions.

Changes

• Fixed a memory leak in starting VM with a removable drive that could lead to a crash in rare circumstances
• Fixed a race condition in CocoaSpice that could lead to a crash or freeze on other running VMs if one VM is stopped
• (iOS) Jailbreak detection for iOS 14 improved so startup message will not show up when jailbroken
• (macOS) Improved icon at low resolutions
• (macOS) BREAKING CHANGE: App Sandbox is re-enabled starting with this build. You need to move any existing VMs. Please read the section below for more details.

macOS Sandbox Migration

When you open UTM you will not see any VMs you previously created! To fix this, move your .utm files from ~/Documents to ~/Library/Containers/com.utmapp.UTM/Data/Documents. You can do it in Terminal with the following command:

mv ~/Documents/*.utm ~/Library/Containers/com.utmapp.UTM/Data/Documents

or with Finder

1. Open Finder and go to your home directory.
2. Press Cmd+Shift+. (that's the period key) to show hidden files.
3. Browse to Library -> Containers -> UTM -> Data -> Documents
4. Copy or move your .utm files from your home's Documents directory to this directory.

Known Issues

• Black screen or crash trying to start any VM? Make sure you read all the instructions in the install page.
• Cannot import any drives/ISO: there is a bug in iOS where an invalid "application-identifier" entitlement causes the file picker to not work. A fix for iOS App Signer is submitted and can be manually compiled. If you are using AltStore, you need use a free (not paid) developer account.
• When installed via Cydia/Sileo, Settings and Files integration does not work and VMs are not deleted automatically when uninstalled.

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

v2.0.16

Installation

Visit https://getutm.app/install/ for the most up to date installation instructions.

Changes

• (iOS) Black screen when booting aarch64 VMs (#2080)
• (iOS) External mouse/touchpad right click and middle click broken (#523)
• (iOS) New setting option to disable screen dimming when VM is running (#1217)
• (iOS) New Cydia repo for jailbroken users: https://cydia.getutm.app/

Known Issues

• Black screen or crash trying to start any VM? Make sure you read all the instructions in the install page.
• Cannot import any drives/ISO: there is a bug in iOS where an invalid "application-identifier" entitlement causes the file picker to not work. A fix for iOS App Signer is submitted and can be manually compiled. If you are using AltStore, you need use a free (not paid) developer account.
• When installed via Cydia/Sileo, Settings and Files integration does not work and VMs are not deleted automatically when uninstalled.

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

UTM

UTM 2.0 includes a redesign of the frontend for iOS 14 and introduces support for macOS 11. Due API limitations, the new design will not be available for iOS 13 and below. That means any feature that depends on the new design will also not be back-ported to iOS 13. Launching UTM 2.0 on iOS 14 will show the new design and launching UTM 2.0 on iOS 13 and below will show the old design. UTM 2.0 also updates the QEMU backend from 4.2.0 to 5.2.0 (for all supported iOS versions).

Installation instructions differ depending on what version of iOS you are running:

• iOS 11-13: You can install and run UTM using any version of AltStore (recommended) or iOS App Signer.
• iOS 14: You must either be jailbroken or follow the tethered launch instructions every time you launch UTM. Note that the jailbroken instructions are currently outdated. If you have a good guide, please let us know.
• iOS 14.2+: You can use either AltStore (>= 1.4.2) or iOS App Signer. Note A11 and older devices are not supported by this method and must be jailbroken or use tethered launch.

As always, please report all bugs to Github

Changes

• QEMU option to use write-through cache to prevent HDD corruption when terminating a VM unexpectedly
• Support virtio-gpu on aarch64 for dynamic resolution on Linux and Windows (with the proper drivers) (#1230)
• Fix a crash when an invalid shared directory is specified (#528)
• Show an error message when shared directory or removable drive specified is invalid
• When no shared directory is specified, use a temporary directory
• (iOS) Clipboard sharing works when running UTM side by side with another app
• (macOS) Fix hypervisor on Intel Macs (#570)
• (macOS) Fix auto determine core count on Intel Macs
• (macOS) Implement clipboard sharing (SPICE tools needed) (#1204)
• (macOS) Fix cursor issues when using virtio-gpu
• (macOS) Support deleting port forward settings (#1226)

Known Issues

• Cannot import any drives/ISO: there is a bug in iOS where an invalid "application-identifier" entitlement causes the file picker to not work. A fix for iOS App Signer is submitted and can be manually compiled. If you are using AltStore, you need use a free (not paid) developer account.
• Starting a VM goes to a black screen on iOS 14: you need to sign UTM with a "development" certificate. If you used a 3rd party signing service, it is probably signed with the wrong certificate. If you signed UTM yourself, make sure you chose a "development" certificate and in iOS App Signer, "No get-task-allow" is unchecked.

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

UTM

UTM 2.0 includes a redesign of the frontend for iOS 14 and introduces support for macOS 11. Due API limitations, the new design will not be available for iOS 13 and below. That means any feature that depends on the new design will also not be back-ported to iOS 13. Launching UTM 2.0 on iOS 14 will show the new design and launching UTM 2.0 on iOS 13 and below will show the old design. UTM 2.0 also updates the QEMU backend from 4.2.0 to 5.2.0 (for all supported iOS versions).

Installation instructions differ depending on what version of iOS you are running:

• iOS 11-13: You can install and run UTM using any version of AltStore (recommended) or iOS App Signer.
• iOS 14: You must either be jailbroken or follow the tethered launch instructions every time you launch UTM. Note that the jailbroken instructions are currently outdated. If you have a good guide, please let us know.
• iOS 14.2: You can use either AltStore (>= 1.4.2) or iOS App Signer. Note A11 and older devices are not supported by this method and must be jailbroken or use tethered launch.

As always, please report all bugs to Github

Changes

• QEMU updated to v5.1.0 release with v4 of @agraf's hypervisor patches for M1
• Update Korean localization (thanks @obbcth)
• Default clipboard sharing setting to on for 'pc' and 'virt' targets on new VMs (SPICE tools still required)
• (macOS) Default hypervisor to on. Note: this overrides any previous setting due to confusion caused by a bug in the last release where the settings dialog shows hypervisor on while it is actually off. This also changes the wording of the setting so checking the box now disables hypervisor. This is to align with the idea that default = off position in the settings.
• (macOS) Disable pause button when hypervisor is used (pausing is not supported by QEMU)
• (macOS) Fix various issues closing+reopening a VM window
• (macOS) Fix a crash if VM was resized and then re-opened (#1203)
• (iOS) Fix invalid TB size from config value (#1214)

Known Issues

• Cannot import any drives/ISO: there is a bug in iOS where an invalid "application-identifier" entitlement causes the file picker to not work. A fix for iOS App Signer is submitted and can be manually compiled. If you are using AltStore, you need use a free (not paid) developer account.
• Starting a VM goes to a black screen on iOS 14: you need to sign UTM with a "development" certificate. If you used a 3rd party signing service, it is probably signed with the wrong certificate. If you signed UTM yourself, make sure you chose a "development" certificate and in iOS App Signer, "No get-task-allow" is unchecked.

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

UTM

UTM 2.0 includes a redesign of the frontend for iOS 14 and introduces support for macOS 11. Due API limitations, the new design will not be available for iOS 13 and below. That means any feature that depends on the new design will also not be back-ported to iOS 13. Launching UTM 2.0 on iOS 14 will show the new design and launching UTM 2.0 on iOS 13 and below will show the old design. UTM 2.0 also updates the QEMU backend from 4.2.0 to 5.2.0 (for all supported iOS versions).

Installation instructions differ depending on what version of iOS you are running:

• iOS 11-13: You can install and run UTM using any version of AltStore (recommended) or iOS App Signer.
• iOS 14: You must either be jailbroken or follow the tethered launch instructions every time you launch UTM. Note that the jailbroken instructions are currently outdated. If you have a good guide, please let us know.
• iOS 14.2: You can use either AltStore (>= 1.4.2) or iOS App Signer. Note A11 and older devices are not supported by this method and must be jailbroken or use tethered launch.

As always, please report all bugs to Github

Changes

• (macOS) Starting a VM on Intel Macs shows dylib error (#721)
• Default BIOS for virt machines (no longer need to manually import a BIOS file to boot)
• Default USB 3.0 controller for virt machines (fixes BUGCODE_USB_DRIVER BSOD on Windows 10 ARM)
• (macOS) Sometimes settings modal is disabled after importing/add/removing a drive (#901)
• After selecting an architecture and machine, sane default settings will be applied to other places
• (macOS) Fix port forwarding
• Add support for NVMe and USB drive interfaces (for Windows 10 ARM)
• Simplify disk creation popup (removed confusing options)
• (macOS) Improved mouse capture handling (#710)

Known Issues

• Cannot import any drives/ISO: there is a bug in iOS where an invalid "application-identifier" entitlement causes the file picker to not work. A fix for iOS App Signer is submitted and can be manually compiled. If you are using AltStore, you need use a free (not paid) developer account.
• Starting a VM goes to a black screen on iOS 14: you need to sign UTM with a "development" certificate. If you used a 3rd party signing service, it is probably signed with the wrong certificate. If you signed UTM yourself, make sure you chose a "development" certificate and in iOS App Signer, "No get-task-allow" is unchecked.

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

UTM

UTM 2.0 includes a redesign of the frontend for iOS 14 and introduces support for macOS 11. Due API limitations, the new design will not be available for iOS 13 and below. That means any feature that depends on the new design will also not be back-ported to iOS 13. Launching UTM 2.0 on iOS 14 will show the new design and launching UTM 2.0 on iOS 13 and below will show the old design. UTM 2.0 also updates the QEMU backend from 4.2.0 to 5.2.0 (for all supported iOS versions).

Installation instructions differ depending on what version of iOS you are running:

• iOS 11-13: You can install and run UTM using any version of AltStore (recommended) or iOS App Signer.
• iOS 14: You must either be jailbroken or follow the tethered launch instructions every time you launch UTM. Note that the jailbroken instructions are currently outdated. If you have a good guide, please let us know.
• iOS 14.2: You can use either AltStore (>= 1.4.2) or iOS App Signer. Note A11 and older devices are not supported by this method and must be jailbroken or use tethered launch.

As always, please report all bugs to Github

Changes

• Updated QEMU backend from 5.1.0 to 5.2.0-rc3 with additional patches for virtualization support on Apple M1 Macs
• Potentially VM breaking change: For newly created VMs, -device virtio-gpu-pci is no longer added by default to virt machines (ARM64). This is due to newer versions of OVMF not supporting the option. On existing VMs, the option is moved to QEMU custom arguments.
• An issue prevented auto-detection of CPU cores on supported configurations (weak on weak)
• Correct missing names for some network cards (#706)
• Some minor description changes in System settings
• (iOS 14) Removable drives and shared directory works outside of the sandbox
• (macOS) Bug where new VM button was not working (#704)
• (macOS) Fix mouse dragging in capture mode
• (macOS) Disabled App Sandbox since a macOS bug prevents Hypervisor.framework from working inside an inherited Sandbox (FB8921623)

Known Issues

• Cannot import any drives/ISO: there is a bug in iOS where an invalid "application-identifier" entitlement causes the file picker to not work. A fix for iOS App Signer is submitted and can be manually compiled. If you are using AltStore, you need use a free (not paid) developer account.
• Starting a VM goes to a black screen on iOS 14: you need to sign UTM with a "development" certificate. If you used a 3rd party signing service, it is probably signed with the wrong certificate. If you signed UTM yourself, make sure you chose a "development" certificate and in iOS App Signer, "No get-task-allow" is unchecked.

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