Skip to content

VirtualBuddy Release Notes

Guilherme Rambo · Create and run macOS and selected ARM Linux virtual machines on Apple silicon, with installer downloads and guest sharing.

CaskVirtualization & ContainersAuto-updates 9K
Install command
brew install --cask virtualbuddy
30-day installs
390
#475 in App
1-year installs
2.7K
Last 365 days
Latest version
2.2.1
Download size
22MB
dmg
Release cadence
Every 2 weeks
2 releases in 30 days
  1. 2.3-b1-prerelease

    LatestPre-release

    GitHub Release

    Version 2.3 Beta 1

    What's New in VirtualBuddy 2.3 Beta 1

    Change Settings While a Virtual Machine Is Running

    You can now add or remove shared folders and change the display resolution while a virtual machine is running. Open Virtual Machine Settings from the window toolbar or the Guest menu.

    For macOS virtual machines, changing the display resolution while running requires macOS 14 or later on both the host and the guest.

    Guest Appearance

    You can now turn Dark Mode on or off in a macOS virtual machine from its window toolbar. Click the VirtualBuddyGuest status button and turn on “Automatically Sync with Host” if you want the guest to follow your Mac’s appearance.

    These controls require an up-to-date copy of VirtualBuddyGuest running in the virtual machine.

    Guest System Information

    The library now shows the macOS version and build last reported by VirtualBuddyGuest, even after you update macOS inside the virtual machine. Control-click a virtual machine and choose Get Info to see details such as its kernel version, memory, and System Integrity Protection status. You can still view the last report when the virtual machine is shut down.

    Other Changes & Improvements

    • If a virtual machine stops responding, choose Guest > Force Stop & Close or Option-click the window’s close button. Once you confirm, VirtualBuddy stops the virtual machine immediately and closes its window.
    • VirtualBuddyGuest now checks that an update supports the guest’s macOS version before installing it.
    • Administrators can now use managed preferences to disable the SSH and automatic login options when setting up a new macOS virtual machine.
    • The software catalog now shows shared compatibility warnings above the list of restore images and tells you when an image requires a newer version of VirtualBuddy.
    • VirtualBuddy now explains that installing a new macOS 27 virtual machine from a restore image requires a host Mac running macOS 26 or later with compatible device support. You can still upgrade an existing virtual machine using Software Update inside the guest.

    Full Changelog: 2.2.1...2.3-b1

  2. 2.2.1 (430)

    OpenNavo editorial

    CompatibilitymacOS 14 or later

    Fixes failure to save a virtual machine's state when the VirtualBuddy library is stored in a custom location, such as a separate volume. The stable update feed identifies version 2.2.1 as build 430.

    Fixes failure to save a virtual machine's state when the VirtualBuddy library is stored in a custom location, such as a separate volume. The stable update feed identifies version 2.2.1 as build 430.

    Official source

  3. 2.2.1

    Patch

    OpenNavo editorial Added to Homebrew

    Fixes failure to save a virtual machine's state when the VirtualBuddy library is stored in a custom location, such as a separate volume. The stable update feed identifies version 2.2.1 as build 430.

    Fixes failure to save a virtual machine's state when the VirtualBuddy library is stored in a custom location, such as a separate volume. The stable update feed identifies version 2.2.1 as build 430.

    Official release notes · Update feed

  4. 2.2 (428)

    Expand

    OpenNavo editorial Added to Homebrew

    CompatibilitymacOS 14 or later · Native on Apple silicon

    Adds saving and resuming supported macOS VM state, configurable close behavior and saved-state indicators. Adds a Guest menu, input toggles, configuration copying and managed restrictions. USB passthrough and preconfigured accounts that skip Setup Assistant require macOS 27 on host and guest. Improves guest clipboard integration and networking; fixes APFS corruption and overwriting a VM

    Adds saving and resuming supported macOS VM state, configurable close behavior and saved-state indicators. Adds a Guest menu, input toggles, configuration copying and managed restrictions. USB passthrough and preconfigured accounts that skip Setup Assistant require macOS 27 on host and guest. Improves guest clipboard integration and networking; fixes APFS corruption and overwriting a VM with the same name. Requires an Apple silicon Mac with macOS 14+. Source: https://github.com/insidegui/VirtualBuddy/releases/tag/2.2

  5. 2.2

    Expand

    GitHub Release Added to Homebrew

    VirtualBuddy 2.2 requires macOS 14 or later on your Mac. You can still run virtual machines with older versions of macOS.

    New Features

    Save and Resume

    • You can now save a macOS virtual machine's running state when closing its window or quitting VirtualBuddy, then resume where you left off.
    • A new setting lets you choose what happens when you close a running virtual machine: save its state, shut it down, or ask every time.
    • Saved state information now appears in the library and the virtual machine window.

    Saving state is available for supported macOS virtual machines after installation is complete. Disk images must be stored inside the virtual machine bundle on a volume that supports file cloning, and USB devices must be detached. VirtualBuddy explains when the current configuration doesn't support saving state.

    macOS Golden Gate Features

    • You can now skip Setup Assistant by configuring a macOS account before starting a new virtual machine for the first time.
    • USB passthrough lets you connect USB devices from your Mac to a macOS virtual machine.

    Skipping Setup Assistant and USB passthrough require macOS 27 or later on both your Mac and the macOS virtual machine. Configure the account before the virtual machine's first startup to skip Setup Assistant.

    More Control Over Your Virtual Machines

    • You can now copy settings from an existing virtual machine using the configuration window.
    • The new Guest menu brings together controls for starting, stopping, and pausing a virtual machine, along with options to reconnect or change its network interface for the current session.
    • New toolbar controls let you turn keyboard and mouse or trackpad input on or off for a virtual machine. To toggle keyboard input, press and hold Command+Option+Control for a few seconds. To toggle mouse or trackpad input, press and hold Option+Control+Shift for a few seconds.
    • You can now open a virtual machine's configuration directly from its contextual menu in the library.
    • Administrators can now restrict shared folders, USB passthrough, bridged networking, VirtualBuddyGuest, and microphone input through managed preferences or configuration profiles. Documentation and a preference manifest can be exported from Settings > Virtualization.

    Enhancements & Bug Fixes

    • Adopts Liquid Glass in setup, configuration, and virtual machine windows on macOS 26 or later.
    • VirtualBuddy now detects conflicting MAC addresses when starting a virtual machine and offers to generate a new address to avoid networking problems.
    • Bridged networking now reconnects automatically when the selected network interface becomes available again.
    • A completely new implementation improves communication with VirtualBuddyGuest, including faster and more reliable clipboard sharing.
    • The virtual machine toolbar now shows the VirtualBuddyGuest connection status and instructions for connecting it. Shared folder settings also provide clearer guidance when the guest app is disabled or not available.
    • Improves VirtualBuddyGuest installation, updates, and automatic launch at login.
    • VirtualBuddy now checks which features are supported when you use a custom macOS restore image and reflects that support in the configuration window.
    • Fixes installation from local restore image files and improves error reporting when required device support software can't be installed.
    • Improves the error message when you've reached the limit on running virtual machines.
    • Addresses an issue that could cause APFS disk corruption in macOS virtual machines.
    • Fixes an issue where creating a virtual machine with an existing name could overwrite another virtual machine.
    • Fixes an issue that could prevent the Linux software catalog from loading.
    • Fixes boot deep links failing to start a shut-down virtual machine when its window was already open.
    • Improves configuration window performance and fixes the Configure command not always updating its availability.
    • Addresses issues with virtual machine windows in full screen.

    Full Changelog: 2.1...2.2.

  6. 2.2-b6-prerelease

    Expand

    GitHub Release

    Version 2.2 Beta 6

    What's New in VirtualBuddy 2.2 Beta 6

    Save and Resume Virtual Machines

    You can now save a running macOS virtual machine's state when closing its window or quitting VirtualBuddy, then resume where you left off. General settings let you choose whether to save state, shut down, or ask every time.

    Saved virtual machines show the time they were saved in the library and virtual machine window. To keep a saved state for later, duplicate the virtual machine before resuming it.

    Saving requires a macOS guest, a storage volume that supports file cloning, and disk images stored inside the virtual machine. A new option in Storage settings lets you copy external disk images into the virtual machine. Saving isn't available while a USB device is attached or when starting up in recovery mode, DFU mode, or from an installation disk.

    Saved states stay with the virtual machine on the same Mac. They don't preserve shared folder contents or network connections, and may become incompatible after macOS or VirtualBuddy updates.

    Keyboard and Mouse Shortcuts

    You can now turn input to the active virtual machine on or off by pressing and holding Control-Option-Command for two seconds for the keyboard, or Control-Option-Shift for the mouse or trackpad.

    A new onscreen indicator shows progress while you hold the shortcut, confirms whether input is on or off, and displays shortcut reminders when you use the toolbar controls.

    Other Changes & Improvements

    Fixes an issue where creating a virtual machine with a name already in use could overwrite an existing virtual machine. Setup now asks you to choose a different name.
    The virtual machine toolbar now shows VirtualBuddyGuest connection status, with instructions for installing or enabling the guest app.
    Shared folder settings now explain that VirtualBuddyGuest is needed to mount folders automatically, with an option to enable it when it's turned off.
    Turning off VirtualBuddyGuest in a macOS virtual machine's settings now also disables communication with an already installed guest app.
    You can now turn clipboard sharing on or off for Linux virtual machines in Sharing settings. VirtualBuddy also preserves this setting when importing a virtual machine from UTM. Clipboard sharing still requires a compatible Spice agent running in the Linux guest.
    

    Full Changelog: 2.2-b5...2.2-b6

  7. 2.2-b5-prerelease

    Expand

    GitHub Release

    Version 2.2 Beta 5

    What's New in VirtualBuddy 2.2 Beta 5

    • Adds a new socket-based implementation of the VirtualBuddyGuest app protocol for faster and more reliable clipboard sharing; requires guests running macOS 14 or later
    • Adds new toggles to the virtual machine window toolbar that can be used to toggle mouse and keyboard input on/off
    • Addresses an issue where boot deep links would not work when the virtual machine window was already open
    • Adds support for managed preferences that can be used to restrict shared folders, USB passthrough, bridged networking, guest app, and microphone input

    Full Changelog: https://github.com/insidegui/VirtualBuddy/compare/2.2-b4...2.2-b5

  8. 2.2-b3-prerelease

    Expand

    GitHub Release

    Version 2.2 Beta 3

    What's New in VirtualBuddy 2.2 Beta 3

    Improved Bridged Networking

    VirtualBuddy now monitors the selected bridged network interface and automatically reconnects it to the guest when the interface becomes available again.

    The new Guest menu provides start, stop, and pause actions, plus a Network submenu for reconnecting or switching bridged network interfaces during the current virtual machine session.

    Other Changes & Improvements

    VirtualBuddyGuest now automatically uses a compatible legacy build when the built-in version doesn't support the guest's macOS release.
    Fixes an issue that could prevent installation from a manually selected local IPSW after the software catalog was refreshed.
    Installation failures using the new macOS installation mechanism for macOS Golden Gate now show the underlying MobileDevice error and provide an option to export the relevant logs.
    You can now configure a virtual machine directly from its context menu in the library. (by @ElSteverino)
    You can now increase the boot disk size of macOS virtual machines that have APFS encryption and FileVault turned off. (by @balcsida)
    

    Full Changelog: 2.2-b2...2.2-b3

  9. 2.2-b2-prerelease

    Expand

    GitHub Release

    Version 2.2 Beta 2

    What's New in VirtualBuddy 2.2 Beta 2

    Note: build 366 fixes a crash in the VirtualBuddyGuest app.

    Install macOS 27 guests in macOS 26 hosts

    This build includes a new macOS virtual machine installation mechanism that works around the Virtualization bugs that are preventing macOS 27 virtual machines from being installed successfully in macOS 26 hosts.

    Currently this is only used when installing macOS 27. If you'd like to force VirtualBuddy to always use this new mechanism for installing macOS, run the following command in Terminal:

    defaults write codes.rambo.VirtualBuddy VBForceVirtualInstallationBackend -bool YES

    Other Changes & Improvements

    Improves validation of macOS account details to prevent errors when attempting to boot the provisioned virtual machine for the first time.
    The installation log console has been redesigned and it now recovers log messages produced before the console was opened (up to 30 minutes of logs are recovered).
    Addresses an issue that caused an installation alert to show up when attempting to open a duplicated virtual machine.
    

    Full Changelog: 2.2-b1...2.2-b2

  10. 2.2-b1-prerelease

    Expand

    GitHub Release

    Version 2.2 Beta 1

    What's New in VirtualBuddy 2.2 Beta 1

    ⚠️ Please Read This First ⚠️

    Due to issues with the macOS 27 SDK, this build may crash on launch when running on macOS versions earlier than 26.5. Users with host Macs running macOS earlier than 26.5 should not install this build.

    Skip Setup Assistant

    When configuring a new virtual machine, you can now set up a macOS user account that will be automatically created on first boot, skipping the entire macOS Setup Assistant process.

    You can also configure the virtual machine to automatically log in with the configured user account and enable SSH for remote login.

    This feature requires macOS 27 on both the host and guest.

    Other Changes & Improvements

    You can now copy the configuration from an existing virtual machine when configuring a new one.
    The virtual machine configuration interface now uses the selected restore image to show which features are supported by the guest and host.
    Custom restore images now use best-effort feature detection so configuration options are enabled or disabled more accurately.
    The maximum boot disk image size has been increased to 8 TB.
    Greater adoption of Liquid Glass throughout the interface.
    Addresses an issue that caused the virtual machine window's title bar to cover up the guest Menu Bar, requiring the window to be resized for the guest display to adjust
    Improves the error message shown when a virtual machine fails to boot because the maximum number of simultaneous virtual machines has been reached.
    Fixes an issue that could occur when attempting to boot a virtual machine that uses the same MAC address as another virtual machine. (by @apfritts)
    Mac virtual machines now use cached disk mode for improved reliability. (by @MarvinDontPanic)
    

    Full Changelog: 2.1...2.2-b1

  11. 2.1-326

    Expand

    GitHub Release

    Version 2.1 (326)

    ⚠️⚠️⚠️ This is probably not the version you're looking for!

    This is only meant for those who wish to continue using VirtualBuddy 2.1 with full VirtualBuddyGuest support on older guest OSes. If that's not you, get the latest version of VirtualBuddy here


    This is a build of VirtualBuddy 2.1 that fixes an issue where the VirtualBuddyGuest app could update itself to a newer version that's not compatible with the operating system version running on the guest.

  12. 2.1

    Expand

    OpenNavo editorial Added to Homebrew

    Adds UTM imports and improves guest integration, configuration and recovery.

    Changes
    Imports macOS virtual machines from UTM.Adds a switch for the VirtualBuddyGuest disk image and checks it is current.Adds uncached catalog refresh and redesigned app settings.Confirms quitting while virtual machines are running.Adds a 4K display preset and defaults new Linux VMs to 1080p.Fixes a full-screen crash on macOS Tahoe and improves failed-install recovery.

    VirtualBuddy 2.1

    Adds UTM imports and improves guest integration, configuration and recovery.

    • Imports macOS virtual machines from UTM.
    • Adds a switch for the VirtualBuddyGuest disk image and checks it is current.
    • Adds uncached catalog refresh and redesigned app settings.
    • Confirms quitting while virtual machines are running.
    • Adds a 4K display preset and defaults new Linux VMs to 1080p.
    • Fixes a full-screen crash on macOS Tahoe and improves failed-install recovery.

    The official update feed identifies upstream 2.1 as build 325; the catalog also has a separate 2.1 record. These notes describe that same release, not an additional build-specific change.

    Source: Official 2.1 release.

  13. 2.1-b6-prerelease

    Expand

    GitHub Release

    Version 2.1 Beta 6

    What's New in VirtualBuddy 2.1 Beta 6

    If a download or installation fails, you can now revisit the installation process to adjust most settings, including OS version selection and virtual machine configuration.
    Enhanced error reporting for failed restore image downloads due to HTTP errors or corrupt restore images during installation.
    Resolved an issue where pressing return with the virtual machine name field focused would incorrectly trigger an error feedback, even if the name had not been changed.
    

    Full Changelog: https://github.com/insidegui/VirtualBuddy/compare/2.1-b5...2.1-b6

  14. 2.1-b5-prerelease

    Expand

    GitHub Release

    Version 2.1 Beta 5

    What's New in VirtualBuddy 2.1 Beta 5

    If the VirtualBuddy library is on removable storage and the drive isn’t mounted when the app is launched, it will now notify you instead of displaying an empty library. The library will load automatically once the drive is mounted.
    Enhanced user interface for empty or deleted libraries.
    Updated background for the library view.
    Fixed a crash that occurred when switching the virtual machine window to full screen on macOS 26 beta.
    New Linux virtual machines now default to a 1080p display resolution to simplify setup with live installers.
    A new 4K display preset is now available for Mac and Linux virtual machines.
    

    Full Changelog: https://github.com/insidegui/VirtualBuddy/compare/2.1-b4...2.1-b5

  15. 2.1-b4-prerelease

    Expand

    GitHub Release

    Version 2.1 Beta 4

    What's New in VirtualBuddy 2.1 Beta 4

    Refresh Catalog: Use Command+R or the toolbar refresh button to reload the OS version catalog without caching. This is handy for viewing the latest OS releases.
    If you try to quit VirtualBuddy while virtual machines are running, a confirmation dialog will appear. This allows you to shut down your machines properly before exiting.
    Renaming restore images downloaded with VirtualBuddy no longer triggers a re-download of the same OS version during installation.
    For macOS installations requiring updated device support files, a clearer warning is now shown, along with improved instructions for updating.
    

    Full Changelog: 2.1-b3...2.1-b4

  16. 2.1-b3-prerelease

    Expand

    GitHub Release

    Version 2.1 Beta 3

    What's New in VirtualBuddy 2.1 Beta 3

    Redesigned settings screen.
    ASIF disk image format is now the default on macOS 26 hosts. If you prefer, you can switch back to raw disk images in settings.
    New option in macOS virtual machine settings to enable or disable mounting of the VirtualBuddy guest app disk image.
    VirtualBuddy now ensures that the guest app disk image is up to date before starting a virtual machine.
    Virtual machines with problematic thumbnails will now be automatically migrated.
    Addressed a layout issue in the virtual machine window.
    

    Full Changelog: 2.1-b2...2.1-b3

    From Previous Builds

    Virtual machine thumbnails now use a blurred version of the desktop picture from the guest
    
            You’ll need the VirtualBuddyGuest app installed on the guest
            When you create a new virtual machine from the in-app catalog, it starts with the default desktop picture for that release
            Virtual machines created in the past that had screenshot-based thumbnails will now use a VirtualBuddy fallback thumbnail by default
    
    This build makes some changes to how VirtualBuddy manages the library window. If you notice anything strange in that area, please let me know
    
    VirtualBuddy can now import macOS virtual machines from UTM; just drag a UTM virtual machine file into the VirtualBuddy icon in the Dock or right click a UTM virtual machine file and choose “Open With > VirtualBuddy”
    Right-clicking a macOS version that’s already been downloaded now shows an option to delete the downloaded IPSW
    
  17. 2.1-b2-prerelease

    Expand

    GitHub Release

    Version 2.1 Beta 2

    New in VirtualBuddy 2.1 Beta 2

    Virtual machine thumbnails now use a blurred version of the desktop picture from the guest
    
            You’ll need the VirtualBuddyGuest app installed on the guest
            When you create a new virtual machine from the in-app catalog, it starts with the default desktop picture for that release
            Virtual machines created in the past that had screenshot-based thumbnails will now use a VirtualBuddy fallback thumbnail by default
    
    This build makes some changes to how VirtualBuddy manages the library window. If you notice anything strange in that area, please let me know
    

    Full Changelog: 2.1-b1...2.1-b2

    From Previous Build

    VirtualBuddy can now import macOS virtual machines from UTM; just drag a UTM virtual machine file into the VirtualBuddy icon in the Dock or right click a UTM virtual machine file and choose “Open With > VirtualBuddy”
    Right-clicking a macOS version that’s already been downloaded now shows an option to delete the downloaded IPSW
    
  18. 2.1-b1-prerelease

    Expand

    GitHub Release

    Version 2.1 Beta 1

    New in VirtualBuddy 2.1 Beta 1

    VirtualBuddy can now import macOS virtual machines from UTM; just drag a UTM virtual machine file into the VirtualBuddy icon in the Dock or right click a UTM virtual machine file and choose “Open With > VirtualBuddy” ¹
    Right-clicking a macOS version that’s already been downloaded now shows an option to delete the downloaded IPSW
    

    ¹ Known issue: due to a bug in macOS, you may have to open the UTM file a second time for VirtualBuddy to import the virtual machine.

    Full Changelog: 2.0.1...2.1-b1

  19. 2.0.1

    Expand

    OpenNavo editorial Added to Homebrew

    Fixes bridged-network selection and reduces download and installation CPU usage.

    Fixed
    Fixes bridged network interfaces missing from the configuration picker.Reduces CPU usage during download and installation.

    VirtualBuddy 2.0.1

    Fixes bridged-network selection and reduces download and installation CPU usage.

    • Fixes bridged network interfaces missing from the configuration picker.
    • Reduces CPU usage during download and installation.

    Source: Official release.

  20. 2.0.1-b1-prerelease

    Expand

    GitHub Release

    Version 2.0.1 beta 1

    This build addresses a bug where bridged network interfaces wouldn’t show up when setting up the virtual machine’s network. The network interface selection UI is also more user-friendly.

  21. 2.0-fix

    Expand

    GitHub Release

    Version 2.0

    New in VirtualBuddy 2.0

    Redesigned virtual machine setup process

    • Each version of macOS offered by VirtualBuddy can now display detailed information about its support on the current host OS version and which virtualization features are supported
    • When downloading a macOS version, VirtualBuddy will check if the build is signed by Apple before proceeding
  22. 2.0

    Expand

    OpenNavo editorial Added to Homebrew

    Fixes release-build backend selection and preview-helper definitions.

    Build
    Corrects non-debug installer download and restore backend selection.Removes a duplicate release-only SwiftUI preview helper.

    VirtualBuddy 2.0

    The exact official 2.0 tag points to commit 0f28ca263501ddd55baa303de7a711be2f223677, titled “Fix release build”. Its patch:

    • Corrects non-debug installer branches to assign URLSessionDownloadBackend and VirtualizationRestoreBackend to Backend rather than Installer.
    • Removes the release-only duplicate ProcessInfo.isSwiftUIPreview helper.

    These are precisely verified source/build changes at the 2.0 tag, not an inferred list of user-facing fixes. The later 2.0-fix tag has additional VM-configuration-saving commits; those are not attributed to this earlier 2.0 tag.

    Source: Official exact tag commit.

  23. 2.0-rc

    Expand

    GitHub Release

    Version 2.0 RC

    New in VirtualBuddy 2.0 RC

    Redesigned virtual machine setup process

    • Each version of macOS offered by VirtualBuddy can now display detailed information about its support on the current host OS version and which virtualization features are supported
    • When downloading a macOS version, VirtualBuddy will check if the build is signed by Apple before proceeding