# 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-70020-41/topic/getting-started.html#vm-setup-overview ## Set up an Ubuntu VM on Windows Prerequisites to set up an Ubuntu VM on Windows Verify hardware and software requirements before setting up an Ubuntu VM on a Windows host computer. https://docs.qualcomm.com/doc/80-70020-41/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#prereq-windows Install Ubuntu in WSL Verify and install Ubuntu 22.04 on a Windows host computer using Windows Subsystem for Linux (WSL). https://docs.qualcomm.com/doc/80-70020-41/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#install-ubuntu-22-04-linux-distribution Configure global settings for WSL Configure WSL settings: memory, processors, and swap storage. https://docs.qualcomm.com/doc/80-70020-41/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#conf-global-sets-for-wsl Configure Ubuntu settings in WSL Configure DNS, Git, and local settings for WSL. https://docs.qualcomm.com/doc/80-70020-41/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#conf-ubuntu-sets-for-wsl ## 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-70020-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-70020-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-70020-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-70020-41/topic/set-up-an-ubuntu-vm-on-an-arm64-based-mac.html#install-ubuntu-on-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-70020-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-70020-41/topic/set-up-an-ubuntu-vm-on-an-arm64-based-mac.html#configure-power-settings-arm64 ## Set up an Ubuntu VM on an x86\_64 Mac Prerequisites to set up an Ubuntu VM on an x86\_64 Mac Verify hardware and software requirements before setting up an Ubuntu VM on an x86\_64 Mac host computer. https://docs.qualcomm.com/doc/80-70020-41/topic/set-up-an-ubuntu-vm-on-an-intel-based-x86-64-mac.html#intel-based-x86-64-mac-host-system-and-software-requirements Install UTM on an x86\_64 Mac Install the UTM virtualization software on an x86\_64 Mac host computer. https://docs.qualcomm.com/doc/80-70020-41/topic/set-up-an-ubuntu-vm-on-an-intel-based-x86-64-mac.html#install-utm-x8664-mac Create a VM in UTM on an x86\_64 Mac Set up and configure a VM in UTM on an x86\_64 Mac host computer. https://docs.qualcomm.com/doc/80-70020-41/topic/set-up-an-ubuntu-vm-on-an-intel-based-x86-64-mac.html#create-a-vm-in-utm-x8664-mac Install Ubuntu in UTM on an x86\_64 Mac Use the Ubuntu ISO image to install Ubuntu in a VM on an x86\_64 Mac host computer. https://docs.qualcomm.com/doc/80-70020-41/topic/set-up-an-ubuntu-vm-on-an-intel-based-x86-64-mac.html#install-ubuntu-on-vm-on-intel-based-x86-64-mac Access the Qualcomm Linux development kit Connect the Qualcomm Linux development kit to the x86\_64 Mac and access it from the Ubuntu VM. https://docs.qualcomm.com/doc/80-70020-41/topic/set-up-an-ubuntu-vm-on-an-intel-based-x86-64-mac.html#access-rb3-gen-2-device-from-x86-64-based-mac Configure power settings for x86\_64 Mac and Ubuntu Configure settings to prevent the x86\_64 Mac and the Ubuntu VM from going to sleep due to inactivity. https://docs.qualcomm.com/doc/80-70020-41/topic/set-up-an-ubuntu-vm-on-an-intel-based-x86-64-mac.html#configure-power-settings-x8664 ## 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-70020-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-70020-41/topic/troubleshoot.html#slow-or-unresponsive-host Last Published: Jul 03, 2025 [Next Topic Virtual machine setup overview](https://docs.qualcomm.com/bundle/publicresource/80-70020-41/topics/getting-started.md)