To reinstall the VM, delete the GUI Linux VM.bundle package and run the app again. Subsequent launches of GUILinuxVirtualMachineSampleApp run the installed Linux VM.

MachineIdentifier - The data representation of the VZGenericMachineIdentifier object.

Disk.img - The main disk image of the installed Linux OS.

The contents of the bundle represent the state of the Linux guest, and contain the following: Running multiple VMs requires an app to manage the execution and artifacts of each individual VM. The sample app only supports running one VM at a time, however, the Virtualization framework supports running multiple VMs simultaneously. When the installation finishes, the Linux VM is ready to use.Īs part of the installation process, the Virtualization framework creates a GUI Linux VM.bundle package in your home directory. The VM boots into the OS installer, and the installer’s user interface appears in the app’s window.

Navigate to the ISO image that you downloaded, select the file, and click Open. When you run the app for the first time, it displays a file picker so you can choose the Linux installation ISO image to use for installing your Linux VM. The Linux VM continues running until you shut it down from the guest OS, or when you quit the app. The sample app starts the VM and configures a graphical view that you interact with. Navigate to the Signing & Capabilities panel and select your team ID.īuild and run GUILinuxVirtualMachineSampleApp. Launch Xcode and open GUILinuxVirtualMachineSampleApp.xcodeproj. For more information, see Running Intel Binaries in Linux VMs with Rosetta. Note: If you need to run Intel Linux binaries in ARM Linux on a Mac with Apple silicon, the Virtualization framework supports this capability using the Rosetta translation environment. For an Intel-based Mac, download a Linux ISO image for Intel-compatible CPUs, which is usually indicated by x86_64 or amd64 in the image filename. For a Mac with Apple silicon, download a Linux ISO image for ARM, which is usually indicated by aarch64 or arm64 in the image filename. The Linux ISO image you download must support the CPU architecture of your Mac. Important: The Virtualization framework can run Linux VMs on a Mac with Apple silicon, and on an Intel-based Mac. Download a Linux installation imageīefore you run the sample program, you need to download an ISO installation image from a Linux distribution website. The Xcode project includes a single target, GUILinuxVirtualMachineSampleApp, which is a macOS app that installs a Linux distribution from an ISO image into a VM, and subsequently runs the installed Linux VM. This sample code project demonstrates how to install and run GUI Linux virtual machines (VMs) on a Mac. Install and run GUI Linux in a virtual machine using the Virtualization framework.

Running GUI Linux in a virtual machine on a Mac

Qemu apple silicon