Installation

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

New Features (Summary)

• URL automation and VM downloading (#2670) (thanks @conath) Allows for controlling and downloading VMs with utm:// URL. Check out #2670 for more information.
• (macOS) Improved cursor/keyboard capturing and handling: permit macOS shortcuts (minimize, full-screen) when not captured, fix various cursor bugs, basic support for VoiceOver and capturing, and more.
• (macOS) Various UI enhancements: export log/args to file (#3056), title bar changes (#3125), exit confirmation works beyond Cmd+Q/W (#3154) (thanks @ktprograms and @conath)

Changes

• Fixed DNS resolution on IPv6
• Updated zh-Hans localization (thanks @ty-yqs)
• Ensure temporary files are deleted when VM creation is canceled (#3012)
• Support re-generating and customizing MAC address (#2724)
• On PC/Q35 devices, USB mouse and keyboard will be disabled in order to prevent interference with the PS/2 keyboard and mouse that is always added to the machines. Some software such as Windows Installer will not work with the second mice.
• (macOS) Move VM name in main window from title to subtitle, reduces confusion when switching windows (#3099) (thanks @conath)
• (macOS) Show confirmation alert when closing/quitting with the menu or the button (#3103) (thanks @ktprograms)
• (macOS) Error alert (instead of crash) when trying to use unsupported features on < macOS 11.3 (#3118)
• (macOS) Support starting input capture with Ctrl+Opt (#3119)
• (macOS) Reduced UI thread blocking in terminal mode with lots of output spewing (#2404, #2555)
• (macOS) Add alternative hotkey for capture (Cmd+Opt) (#2710)
• (macOS) Unhide cursor when popup alert shows (#3101)

Known Issues

• Networking can be broken in some instances, we are still investigating the cause. (#3051, #3094)

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.

New Features (Summary)

• (macOS 11.3+ Only) Bridged networking and shared networking support. You can configure it in the Network settings for your VM.
• (macOS 11+ and iOS 13+) GPU acceleration for OpenGL on Linux. Use virtio-ramfb-gl or virtio-vga-gl display device and compatible Linux drivers (most modern Linux distros will have it already installed). Windows is not supported because there is currently no virtio-gpu driver for Windows that supports 3D acceleration. Note that newly created VMs will default to a "GPU Supported" display device on supported architectures but existing VMs must manually change the display device in Display settings. GPU acceleration is still an experimental feature, so it may not work in some situations (including many 3D use cases).
• EFI Boot. By default new VMs created for pc, q35, and virt* machines will have EFI enabled. In previous versions, EFI is only enabled for virt* machines. Due to compatibility with boot, existing pc and q35 VMs will NOT have EFI enabled and must be manually turned on in Settings -> System -> Advanced Configuration -> UEFI Boot. This may also require you to re-install the bootloader on your VM. As part of this change, EFI variables will also be properly handled (on both ARM and x86 VMs). Note that if you've configured a custom pflash device for your VM, the new UEFI Boot option will take no effect (same as before).
• QEMU v6.1.0 is now used for the backend.

Changes (v2.2.1)

• Fix crash when setting custom VM icon (#2387) (thanks @ktprograms)
• Disable Port Forwarding feature for bridged networking (thanks @conath)
• Fixed memory leak (#2720)

Changes (v2.2.2)

• (iOS) Enable OpenGL acceleration for iOS 11-12
• (iOS 15+) Increased memory limit for supported devices (M1 iPads currently)
• (macOS) Fix layout issues in settings on macOS Monterey (#2644)
• (macOS) Fix capturing of hotkeys (such as Cmd+Tab) (#2677)
• Disable port forwarding options for shared & bridged networking
• Fixed crash when PPC screamer is selected on iOS (currently this is still not supported)
• Refactored non-OpenGL rendering code, fixing some random crashes seen in TestFlight reports.

Changes (v2.2.3)

• (iOS) When a mouse/trackpad is already connected when UTM starts up, it will now be properly detected (#3013)
• (iOS) Handle touch and Apple Pencil input while the mouse is captured (#2669)
• Windows BSOD on boot/setup due to PAGE_FAULT_IN_NONPAGED_AREA (#2721)

Changes (v2.2.4)

• (macOS) Settings no longer crash when an error occurs while saving a new VM
• (iOS) GL rendering now works on EFI startup (black screen during boot) (#3076)

Known Issues

• v2.2.4 is built with Xcode 12.5.1 instead of Xcode 13.0 beta due to Apple's strict requirements in submitting apps built on beta SDKs. As a result, the layout issues in settings on macOS Monterey are back in v2.2.4. This will be resolved when Xcode 13 is released.
• Networking can be broken in some instances, we are still investigating the cause. (#3051, #3094)

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

Note: this beta build has breaking changes. Please read the notes below for more information.

Installation

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

New Features (v2.2.0)

• (macOS 11.3+ Only) Bridged networking and shared networking support. You can configure it in the Network settings for your VM.
• (macOS 11+ and iOS 13+) GPU acceleration for OpenGL on Linux. Use virtio-ramfb or virtio-gpu-gl-pci display device and compatible Linux drivers (most modern Linux distros will have it already installed). Windows is not supported because there is currently no virtio-gpu driver for Windows that supports 3D acceleration.

Changes (v2.2.2)

• (iOS) Enable OpenGL acceleration for iOS 11-12
• (iOS 15+) Increased memory limit for supported devices (M1 iPads currently)
• (macOS) Fix layout issues in settings on macOS Monterey (#2644)
• (macOS) Fix capturing of hotkeys (such as Cmd+Tab) (#2677)
• Disable port forwarding options for shared & bridged networking
• Fixed crash when PPC screamer is selected on iOS (currently this is still not supported)
• Refactored non-OpenGL rendering code, fixing some random crashes seen in TestFlight reports.

Changes (v2.2.3)

• (iOS) When a mouse/trackpad is already connected when UTM starts up, it will now be properly detected (#3013)
• (iOS) Handle touch and Apple Pencil input while the mouse is captured (#2669)
• Windows BSOD on boot/setup due to PAGE_FAULT_IN_NONPAGED_AREA (#2721)
• EFI Boot is now a configurable option: by default new VMs created for pc, q35, and virt* machines will have EFI enabled. In previous versions, EFI is only enabled for virt* machines. Due to compatibility with boot, existing pc and q35 VMs will NOT have EFI enabled and must be manually turned on in Settings -> System -> Advanced Configuration -> UEFI Boot. This may also require you to re-install the bootloader on your VM. As part of this change, EFI variables will also be properly handled (on both ARM and x86 VMs). Note that if you've configured a custom pflash device for your VM, the new UEFI Boot option will take no effect (same as before).
• Added virtio-ramfb-gl device to support GPU Acceleration. On previous beta builds, GL is enabled automatically for virtio-ramfb. Now, that display device will not get GPU acceleration. This is to be more consistent with the other -gl display devices. By default, new VMs created will have virtio-ramfb-gl selected for virt devices (ARM) and virtio-vga-gl selected for q35 and pc devices (x86). If you wish to use GPU acceleration on an existing VM, you need to change your display device to one of these two recommended devices (or any device with -gl in the name).

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.

New Features (v2.2.0)

• (macOS 11.3+ Only) Bridged networking and shared networking support. You can configure it in the Network settings for your VM.
• (macOS 11+ and iOS 13+) GPU acceleration for OpenGL on Linux. Use virtio-ramfb or virtio-gpu-gl-pci display device and compatible Linux drivers (most modern Linux distros will have it already installed). Windows is not supported because there is currently no virtio-gpu driver for Windows that supports 3D acceleration.

Changes (v2.2.2)

• (iOS) Enable OpenGL acceleration for iOS 11-12
• (iOS 15+) Increased memory limit for supported devices (M1 iPads currently)
• (macOS) Fix layout issues in settings on macOS Monterey (#2644)
• (macOS) Fix capturing of hotkeys (such as Cmd+Tab) (#2677)
• Disable port forwarding options for shared & bridged networking
• Fixed crash when PPC screamer is selected on iOS (currently this is still not supported)
• Intel Macs will use EFI boot if virtio-* graphics card is selected (fixes black screen on boot)
• Refactored non-OpenGL rendering code, fixing some random crashes seen in TestFlight reports.

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.

New Features (v2.2.0)

• (macOS 11.3+ Only) Bridged networking and shared networking support. You can configure it in the Network settings for your VM.
• (macOS 11+ and iOS 13+) GPU acceleration for OpenGL on Linux. Use virtio-ramfb or virtio-gpu-gl-pci display device and compatible Linux drivers (most modern Linux distros will have it already installed). Windows is not supported because there is currently no virtio-gpu driver for Windows that supports 3D acceleration.

Changes (v2.2.1)

• GPU acceleration is now using OpenGL instead of Metal due to compatibility issues. Please report anything that works on v2.2.0 (Metal) but fails on v2.2.1 (OpenGL). If there are many cases of these, then we will add an option to switch between the two backends. From experience though, it seems like the OpenGL backend is more stable and more compatible. However, compatibility is not perfect and you may experience crashes when trying to launch an unsupported app in the guest. As before, GPU acceleration only works on Linux with the correct Mesa drivers installed for virtio.
• QEMU is updated to v6.1.0 (release)
• Fix crash when setting custom VM icon (#2387) (thanks @ktprograms)
• Disable Port Forwarding feature for bridged networking (thanks @conath)
• Fixed memory leak (#2720)

Known Issues

• On Intel Macs, virtio-ramfb and virtio-gpu-pl-pci does not work with BIOS boot. You need to boot from UEFI which currently requires you to manually add a PC Flash device with the UEFI image. In the future, there will be an option to boot from UEFI instead of BIOS.
• On macOS 12, some UI elements are laid out incorrectly due to changes in SwiftUI apis.

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.

New Features

• (macOS 11.3+ Only) Bridged networking and shared networking support. You can configure it in the Network settings for your VM.
• (macOS 11+ and iOS 13+) GPU acceleration for OpenGL on Linux. Use virtio-ramfb or virtio-gpu-gl-pci display device and compatible Linux drivers (most modern Linux distros will have it already installed). Windows is not supported because there is currently no virtio-gpu driver for Windows that supports 3D acceleration.
• QEMU is updated to v6.1.0-rc1

Known Issues

• On Intel Macs, virtio-ramfb and virtio-gpu-pl-pci does not work with BIOS boot. You need to boot from UEFI which currently requires you to manually add a PC Flash device with the UEFI image. In the future, there will be an option to boot from UEFI instead of BIOS.
• On macOS 12, some UI elements are laid out incorrectly due to changes in SwiftUI apis.

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

• Fixed QEMU issue causing crash running x86 Windows on M1 (thanks @kwhr0) (#2630)
• Fixed crash due to bad drive id (#2614)
• Properly delete imported/created drives on a new VM when canceled out (#2576)
• Fixed bad CPU core configuration on SPARC (#2651)
• Improvement to zh-Hant translation (thanks @pan93412) (#2595)
• Fixed an unusable CD drive always showing up in Windows x86 (thanks @conath) (#2538)
• (macOS) Fixed an issue with auto resolution changing with SPICE installed (#2587)
• (macOS) Fixed a crash when starting a VM after shutting down (#2622)
• (macOS) New global setting to (try to) only use performance cores: when set, if a VM does not manually specify a core count, instead of using the maximum number of cores on the system, UTM will use only the number of performance cores. Note this does not guarantee only the performance cores are used but only that the number of cores seen by the guest is lower. (#2557)
• (macOS) Fixed screen tearing/glitches on Windows and improved framebuffer rendering performance (#2569)
• (macOS) When SPICE tools are not properly set up, attempting to resize the window will now "revert" the size if the resolution does not get changed by the guest.
• (iOS) Fixed crash when launching with Jitterbug or other imobiledevice tools
• (iOS) Fixed Cydia install on iOS 11 (#2618)

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

This release brings two major features:

USB support is here for macOS and jailbroken iOS. You can attach a device to your VM with the new USB icon in the toolbar. You can enable USB 3.0 in the Share settings for faster devices on supported targets. Note that older versions of Windows (e.g. Windows 7 and below) require installing additional drivers for USB 3.0.

UTM SE is a new build for iOS that does not require JIT (and therefore is much slower). It can therefore be sideloaded on any iOS device that is not jailbroken. Jailbreak users are still recommended to install the standard UTM DEB package for faster JIT speeds and USB support.

Installation

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

Changes (v2.1.1)

• (iOS) Fix USB attach on (jailbroken) iOS 14.6
• Fixed slow UEFI boot due to accidentally including a debug build of EDK2
• (macOS) Fixed captured mouse not being released when VM is shut down or suspended
• (macOS) Trackpad scroll speed made more consistent (#2400)
• (macOS) Fixed Windows 10 not booting on M1 Macs (#2546)
• (macOS) Fixed Screamer audio (#2548) Note that you must now select the 'screamer' audio card for the 'mac99' system target for sound to work.

Changes (v2.1.0)

• QEMU updated from v5.2.0 to v6.0.0
• USB support: attach a USB device to the VM (macOS and jailbroken iOS 14.5 and below only)
• UTM SE (Slow Edition): JITless iOS build available to sideload on any non-jailbroken device (thanks @ktemkin)
• Screamer audio device for PPC mac99 machines

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

This release brings two major features:

USB support is here for macOS and jailbroken iOS. You can attach a device to your VM with the new USB icon in the toolbar. You can enable USB 3.0 in the Share settings for faster devices on supported targets. Note that older versions of Windows (e.g. Windows 7 and below) require installing additional drivers for USB 3.0.

UTM SE is a new build for iOS that does not require JIT (and therefore is much slower). It can therefore be sideloaded on any iOS device that is not jailbroken. Jailbreak users are still recommended to install the standard UTM DEB package for faster JIT speeds and USB support.

Installation

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

Changes

• QEMU updated from v5.2.0 to v6.0.0
• USB support: attach a USB device to the VM (macOS and jailbroken iOS 14.5 and below only)
• UTM SE (Slow Edition): JITless iOS build available to sideload on any non-jailbroken device (thanks @ktemkin)
• Screamer audio device for PPC mac99 machines (no setting changes needed)

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) When file selection for removable drive is closed by tapping outside the modal, trying to open the modal again fails (#2499)
• (macOS) When Cmd/Win key is held, keyUp event was not being handled (#2486)
• Updated welcome screen with links to user guide and support page (#2498)
• bootindex was not properly applied for floppy devices (note: this fix is only for Q35, floppy boot order is unsupported for other targets) (#2492)
• Some targets such as Raspberry Pi fail to start because of an error with "-device usb-ehci" argument (#2505)
• On Q35/PC targets, press Esc to get to boot menu in BIOS (#2504)
• When removable drives are re-ordered, the underlying images assigned to them were not being reordered (#2512)

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