UTM Logo

This guide is designed to only work with Apple Silicon Macs.

Downloads

Instructions

  1. Open UTM and create a new virtual machine.

Step 1

  1. Give the VM a name and optionally choose an icon.

Step 2

  1. In System, select the “ARM64 (aarch64)” architecture, and specify the amount of memory. At least half of your computer’s total memory is recommended for performance.

Step 3

  1. In Drives, select “Import Drive” and select the Windows 10 VHDX that you’ve downloaded. (Please read the troubleshooting section below about a bug with VHDX in QEMU.)

Step 4

  1. After importing the drive, you must set the interface to NVMe.

Step 5

  1. Now click “New Drive” and check Removable and click Create to make add CD drive.

Step 6

  1. Save the VM, and select it in the sidebar. On the bottom right, click Browse and select the SPICE guest tools ISO.

Step 7

  1. Follow the Windows installer. If you have issues with the mouse, press the mouse capture button in the toolbar to send mouse input directly. Press Control+Option together to exit mouse capture mode. Sometimes, due to driver issues, you can enter and exit capture mode and the mouse cursor works normally again.

Step 8

  1. Once installation is complete and you’ve logged in, we can proceed to install the guest tools. With the ISO mounted in the D: drive, open Windows Explorer and browse to D:\. Run spice-guest-tools-xxx.exe which should install all drivers along with QEMU agent, SPICE agent (for copy/paste and dynamic resolution), and shared directory.

Step 9

Note that due to libslirp limitations, ping will not work and so Windows may think that there is still no internet connection.

Enable Higher Resolutions

  1. After installing the SPICE guest tools, go to the desktop, right click anywhere, and choose Display Settings.

Step 10

  1. Scroll down to “Multiple displays” and select “Show only on 1”. The mouse might be stuck in the second display so you will have to use the keyboard to confirm and then restart.

Step 11

Share files with host

  1. With the VM shut down, open the settings and go to the Sharing tab. Make sure “Enable directory sharing” is checked.

Step 12

  1. Under “Shared Directory” click Browse and select the directory to share with the VM.

Step 13

Once booted, with the SPICE guest tools installed, the shared directory should show up as a Network Drive.

Troubleshooting

System drive gets corrupted

Do to an issue with QEMU handling of VHDX images, sometimes Windows will be corrupted from normal usage. This would result in BSOD or random application crashes/errors. To work around this issue, it is recommended that you convert the VHDX image to a QCOW2 image. Currently, UTM does not provide this functionality in the UI so you have to do it directly from QEMU.

  1. Install Homebrew if you do not have it already.
  2. Run brew install qemu
  3. Run qemu-img convert -p -O qcow2 /path/to/Windows10_InsiderPreview_Client_ARM64_en-us_21286.VHDX /path/to/output/Windows10_InsiderPreview_Client_ARM64_en-us_21286.qcow2 replacing the paths with your own.
  4. Use the QCOW2 image with UTM. It is recommended you do this with a fresh VHDX from Microsoft in case your image was already corrupted.