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.

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

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.1.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 the beta 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) Fixed empty error message when creating a new drive (#565)
• (macOS) Implemented debug logging (#575)
• (macOS) Various UI/interface issues fixed
• (macOS) Implemented console display mode
• (macOS) Mouse capture mode stuck on corner of the screen (#576)
• (macOS) Removing a removable disk image on the home screen will now persist if VM is not started
• (iOS) On < A12 devices running iOS 14.2, an error message will show up on startup to alert user that it is not compatible

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 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.1.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 the beta 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

• (iOS 14, macOS): Fixed an issue with the welcome screen not updated for dark mode
• (iOS 14, macOS): Add back the option to specify boot device order.
• (macOS): Fix context menu not showing on right click on the sidebar
• (macOS): Fix play button not working on the sidebar
• (macOS): Sign release to prevent "damaged and cannot be opened" error
• (macOS): Hardened runtime and notarization to prevent gatekeeper issues and "internal error" on startup

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.
• Removable drives (changing images, etc) not working completely yet. For now, use the import drive feature instead to copy the disk image to the .utm bundle.

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

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.1.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.
• iOS 14.2: You can use either the beta 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

• Deleting a drive now actually deletes the data
• Booting Linux kernel works again (#515)
• Fixed default settings not being loaded including default cursor settings
• (macOS) Fixed internal error on startup

Known Issues

• AltStore cannot install UTM on iOS 14: make sure you are running AltStore 1.4.2 or higher. At time of writing, 1.4.2 beta is only available to AltStore Patreon beta testers. For those without access, you can use iOS App Signer.
• 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.
• 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 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.1.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.
• iOS 14.2: You can use either the beta AltStore (1.4.2) or iOS App Signer. Note some people report issues with this, please post the device model you're running if it does not work.

Notice to users of previous versions: If you are running an older version of UTM (v1 or v2 beta), please note that because the bundle identifier has changed, it will install as a new app and AltStore will not show an update for your existing app. You should manually move your VMs to the new app. We are also retiring the distinction of beta vs release. Since we don't have dedicated testers or a QA team, it is misleading to label something as 'beta' or 'release' when every build incrementally improves upon the last one.

As always, please report all bugs to Github

One more thing... macOS 11 universal builds will now be included in the releases. Be warned that currently the macOS builds are still very unstable.

Changes (from last update)

• Fix port forwarding (broken in last update)
• (iOS 14) Add confirmation popup for delete/clone/stop operations
• (iOS 14) Fix issue on iPad where a delete VM still shows its details page

Changes (highlights since v1.0)

• (iOS 14) Brand new UI for the home view and configuration views
• (iOS 14) Advanced mode: bypass QEMU arguments generated by configuration and pass args directly (#381)
• (iOS 14) Sort VMs on home view (#356)
• QEMU updated from 4.2.0 to 5.1.0
• Removable drives and changing discs while VM is running (#109)
• Jailbroken devices can use more JIT memory (#67)

Known Issues

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