# Virtual machine setup documentation Set up an Ubuntu virtual machine (VM) on a Windows^®^ or Mac^®^ host computer to sync, build, and flash the Qualcomm^®^ Linux^®^ software. ## VM setup overview High-level VM setup overview Provides a high-level overview of when to set up an Ubuntu VM. https://docs.qualcomm.com/doc/80-70030-41/topic/getting-started.html#vm-setup-overview ## Set up WSL on Windows and install Ubuntu Verify Windows host system requirements Verify minimum hardware resources required for the WSL environment and Qualcomm Linux builds. https://docs.qualcomm.com/doc/80-70030-41/topic/set-up-an-ubuntu-vm-on-windows.html#verify-windows-host-system-requirements Enable WSL and install Ubuntu Enable Windows Subsystem for Linux (WSL) and install the Ubuntu 22.04 Linux distribution. https://docs.qualcomm.com/doc/80-70030-41/topic/set-up-an-ubuntu-vm-on-windows.html#enable-wsl-and-install-ubuntu Configure Ubuntu settings in WSL Configure WSL-specific settings for Ubuntu using the wsl.conf file. https://docs.qualcomm.com/doc/80-70030-41/topic/set-up-an-ubuntu-vm-on-windows.html#configure-ubuntu-settings-in-wsl Enable USB device access for WSL Use usbipd-win to pass USB device traffic from Windows to WSL for flashing Qualcomm devices. https://docs.qualcomm.com/doc/80-70030-41/topic/set-up-an-ubuntu-vm-on-windows.html#enable-usb-device-access-for-wsl Troubleshoot WSL issues Resolve common issues related to performance, disk space, DNS, build errors, and USB pass-through in WSL. https://docs.qualcomm.com/doc/80-70030-41/topic/set-up-an-ubuntu-vm-on-windows.html#troubleshoot-wsl-issues ## Set up an Ubuntu Server VM on an Arm64 Mac Prerequisites to set up an Ubuntu Server VM on an Arm64 Mac Verify hardware and software requirements before setting up an Ubuntu VM on an Arm64 Mac host computer. https://docs.qualcomm.com/doc/80-70030-41/topic/set-up-an-ubuntu-vm-on-an-arm64-based-mac.html#arm64-based-mac-host-system-and-software-requirements Install UTM on an Arm64 Mac Install the UTM virtualization software on an Arm64 Mac host computer. https://docs.qualcomm.com/doc/80-70030-41/topic/set-up-an-ubuntu-vm-on-an-arm64-based-mac.html#install-utm-on-mac-on-arm64-based-mac Create a VM in UTM on an Arm64 Mac Set up and configure a VM in UTM on an Arm64 Mac host computer. https://docs.qualcomm.com/doc/80-70030-41/topic/set-up-an-ubuntu-vm-on-an-arm64-based-mac.html#create-a-vm-in-utm-on-an-arm64-based-mac Install Ubuntu Server in UTM on an Arm64 Mac Use the Ubuntu ISO image to install Ubuntu Server in a VM on an Arm64 Mac host computer. https://docs.qualcomm.com/doc/80-70030-41/topic/set-up-an-ubuntu-vm-on-an-arm64-based-mac.html#install-ubuntu-on-vm-on-arm64-based-mac Run the Ubuntu Server VM on an Arm64 Mac Start the VM to run Ubuntu Server virtually on an Arm64 Mac. https://docs.qualcomm.com/doc/80-70030-41/topic/set-up-an-ubuntu-vm-on-an-arm64-based-mac.html#run-ubuntu-vm-on-arm64-based-mac Access the Qualcomm Linux development kit Connect the Qualcomm Linux development kit to the Arm64 Mac computer and access it from the Ubuntu Server VM. https://docs.qualcomm.com/doc/80-70030-41/topic/set-up-an-ubuntu-vm-on-an-arm64-based-mac.html#access-rb3-gen-2-device-from-the-utm-vm-for-arm64-based-mac Configure power settings for Arm64 Mac and Ubuntu Server Configure settings to prevent the Arm64 Mac computer and the Ubuntu Server VM from going to sleep due to inactivity. https://docs.qualcomm.com/doc/80-70030-41/topic/set-up-an-ubuntu-vm-on-an-arm64-based-mac.html#configure-power-settings-arm64 ## Troubleshoot host computers and virtual machines Fix network failures in the Ubuntu VM Address intermittent network issues in the Ubuntu VM, which may cause failures during ongoing build compilations. https://docs.qualcomm.com/doc/80-70030-41/topic/troubleshoot.html#fix-network-failures-in-the-ubuntu-vm Optimize slow or unresponsive Mac host computer Check if the UTM VM is using all resources, slowing down the Mac host computer. https://docs.qualcomm.com/doc/80-70030-41/topic/troubleshoot.html#slow-or-unresponsive-host Last Published: Jul 02, 2026 [Next Topic Virtual machine setup overview](https://docs.qualcomm.com/bundle/publicresource/80-70030-41/topics/getting-started.md)