# VirtualBuddy

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

> This is the Markdown version of the VirtualBuddy page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/virtualbuddy>

- **Latest version**: `2.2.1,430`
- **Developer**: Guilherme Rambo
- **Homepage**: <https://github.com/insidegui/VirtualBuddy>
- **Categories**: [Virtualization & Containers](https://opennavo.com/categories/virtualization)
- **Install**: `brew install --cask virtualbuddy`
- **30-day installs**: 384
- **Homebrew**: Available; the app updates itself
- **Download URL**: <https://github.com/insidegui/VirtualBuddy/releases/download/2.2.1/VirtualBuddy_v2.2.1-430.dmg>
- **SHA-256**: `16fac6dddbb012548911c0a6807a882e8df5b5b4897a218923b108aaa333fc63`
- **Commands**: vctool

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "app": [
        "VirtualBuddy.app"
      ],
      "target": "/Applications/VirtualBuddy.app"
    },
    "phase": "install",
    "sources": [
      "VirtualBuddy.app"
    ],
    "target": "/Applications/VirtualBuddy.app",
    "type": "app"
  },
  {
    "declaration": {
      "binary": [
        "$APPDIR/VirtualBuddy.app/Contents/MacOS/vctool",
        {
          "target": "vctool"
        }
      ],
      "target": "$HOMEBREW_PREFIX/bin/vctool"
    },
    "phase": "install",
    "sources": [
      "$APPDIR/VirtualBuddy.app/Contents/MacOS/vctool"
    ],
    "target": "$HOMEBREW_PREFIX/bin/vctool",
    "type": "binary"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Application Support/VirtualBuddy",
            "~/Library/Caches/codes.rambo.VirtualBuddy",
            "~/Library/Caches/VirtualBuddy",
            "~/Library/HTTPStorages/codes.rambo.VirtualBuddy",
            "~/Library/Preferences/codes.rambo.VirtualBuddy.plist"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

VirtualBuddy is a Mac virtualization application focused on developers testing applications across macOS releases, including supported beta environments. It can also run selected ARM Linux distributions.

### Features
- Create a virtual machine using an installation wizard and a catalog of restore images.
- Install macOS from an Apple-hosted IPSW, a custom URL or an existing local image.
- Install supported ARM Linux distributions from ISO files or download links.
- Configure virtual hardware, networking and shared folders.
- Save and restore supported macOS virtual-machine state.
- Use a guest companion for clipboard and shared-folder integration when the guest system supports it.

### Installation and requirements
Download the official DMG and copy the app into Applications, or use `brew install --cask virtualbuddy`. Version 2.2 and later require an Apple silicon Mac with macOS 14 or later. The version-specific release notes and update feed take precedence over the README’s older general macOS 13 requirement. The official feed maps 2.2.1 to build 430 and gives the full DMG size as 22,041,237 bytes; this is not installed size or VM storage. Allocate additional RAM and disk space for guest systems.

The project supports macOS 12 and later guests and selected ARM Linux distributions, subject to host and guest compatibility. Installing macOS Golden Gate beta on a macOS 26 host requires VirtualBuddy 2.2 beta 2 or later and Apple’s latest device-support files, or Xcode 27 beta which includes them. Other newer macOS betas may also need updated device support. Apple Developer downloads may require an Apple account; Xcode is not a blanket requirement for stable guests.

### Guest integration and permissions
The current guest companion requires macOS 14 or later for clipboard sharing and automatic shared-folder mounting. The legacy macOS 13 companion only mounts shared folders; macOS 12 lacks guest-app support. Review shared-folder and clipboard access because they connect guest activity to host data. No named Homebrew cask conflict is declared. The checked project documentation does not prescribe blanket Accessibility, Screen Recording or Full Disk Access for ordinary operation.

### Accounts, network and license
VirtualBuddy is free and open source under a BSD-style license; paid downloads and sponsorship are optional ways to support the developer. The project does not document a VirtualBuddy account requirement. Network access is needed for catalogs, downloads and networked guest tasks. Once installed, local guests can perform local work without relying on a VirtualBuddy cloud account, subject to the guest software's own requirements. Guest operating-system licenses apply separately.

### Practical cautions
Virtual machines are useful test environments but shared folders, clipboard integration and network access can cross isolation boundaries. Avoid connecting sensitive host folders to untrusted guests. Back up important VM files before upgrades and keep sufficient host resources available. Beta guests may be unstable. Check Apple's software license and supported hardware conditions for macOS virtualization rather than treating an available IPSW as permission for every use.

Catalog records 2.2.1,430 and 2.2.1 map to the same upstream release; the official feed identifies build 430. The next recorded version is 2.2,428. Saving state requires a supported, fully installed macOS guest, disk images inside its VM bundle on a volume supporting file cloning, and detached USB devices. USB passthrough and creating a guest account before first boot to skip Setup Assistant require macOS 27 or later on both host and guest.

Sources: [Official project and requirements](https://github.com/insidegui/VirtualBuddy), [Official releases](https://github.com/insidegui/VirtualBuddy/releases), [Official update feed](https://su.virtualbuddy.app/appcast.xml), [License](https://github.com/insidegui/VirtualBuddy/blob/main/LICENSE).

[2.2](https://github.com/insidegui/VirtualBuddy/releases/tag/2.2) · [2.2.1](https://su.virtualbuddy.app/releasenotes.html)

## System requirements

- macOS 14 or later · Version: 2.2.1,430 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/v/virtualbuddy.rb> · Checked 2026-11-22
  - <https://github.com/insidegui/VirtualBuddy/releases/download/2.2.1/VirtualBuddy_v2.2.1-430.dmg>
  - SHA-256: `16fac6dddbb012548911c0a6807a882e8df5b5b4897a218923b108aaa333fc63`

## VirtualBuddy security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/insidegui/VirtualBuddy> · Open source: Yes — <https://github.com/insidegui/VirtualBuddy> · Checked 2026-11-13

## Uninstall

- `brew uninstall --cask virtualbuddy`

A regular uninstall removes the app and keeps its settings and caches.

### Deep clean (optional)

- `brew uninstall --zap --cask virtualbuddy`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/Library/Application Support/VirtualBuddy` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/v/virtualbuddy.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Caches/codes.rambo.VirtualBuddy` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/v/virtualbuddy.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Caches/VirtualBuddy` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/v/virtualbuddy.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/HTTPStorages/codes.rambo.VirtualBuddy` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/v/virtualbuddy.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/codes.rambo.VirtualBuddy.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/v/virtualbuddy.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 2.3-b1-prerelease (2026-11-18)

### 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](https://github.com/insidegui/VirtualBuddy/compare/2.2.1...2.3-b1)

## Facts and sources

- <https://opennavo.com/apps/virtualbuddy>
- <https://opennavo.com/apps/virtualbuddy/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/v/virtualbuddy.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/virtualbuddy>
- <https://github.com/insidegui/VirtualBuddy> · Checked 2026-11-13
