Skip the cutscene

Entry requirements

Hello, Crawler, and welcome to the entrance exam. This page lists what you need on your Mac to run Pomme and to build it from source. Installing a release with Homebrew or the install script doesn’t need Xcode. The System mentions this up front so that nobody downloads a very large app for no reason. The viewers find that kind of thing hilarious, but the System has standards.

Pomme runs only on a Mac with Apple silicon. The pomme executable is built for the arm64 architecture, and Virtualization.framework can run macOS guests only on Apple silicon. There’s no side entrance. The System has checked the walls.

Pomme requires macOS 15 or later on the host.

The host version affects how Pomme installs its guest agent:

  • On a macOS 27 host that creates a fresh macOS 27 guest, Pomme uses Apple’s first-boot provisioning to create the guest’s pomme account and installs the agent over SSH.
  • On older hosts, with older guests, and with templates that already have an owner account, Pomme installs the agent through macOS Recovery.

For details, see Durable creation and journals.

Pomme can attempt to install any restore image that Apple signs for your Mac model. Some macOS versions are reviewed, and other versions are treated as experimental attempts. Experimental attempts are where the ratings come from. For the current list, see Supported macOS versions.

Each VM uses its own memory and disk space. Keep the following limits in mind when you size your VMs:

  • Guest memory: Every VM needs at least 4 GiB of memory. If the restore image declares a higher minimum, Pomme applies that minimum instead. The default is 8GB.
  • Disk size: The default virtual disk size is 60GB. A VM cloned from a template inherits the template’s disk size.
  • Running guests: Virtualization.framework runs at most two macOS guests at the same time.

Two guests at once, Crawler. Not three. The System knows you were about to try.

For short-lived test VMs on a host with 16 GB of memory, use --memory 4GB --disk-size 40GB. Increase these values only when the workload needs more.

Pomme stores each VM’s agent credential and generated owner password in your login Keychain. The login Keychain must be unlocked when you run Pomme. Pomme doesn’t unlock the Keychain for you and doesn’t read your host password. The System isn’t allowed near your password either. It asked. It was told no.

Pomme downloads restore images from Apple’s servers and looks up available versions in the public restore-image catalog. The host needs internet access unless you create VMs from a local restore image or an installed template.

Choosing the hard mode, are we? To build and install Pomme from source, you also need:

  • A full installation of Xcode 27 or later. Pomme builds against the macOS 27 SDK, and the Command Line Tools package alone isn’t enough.
  • The Developer ID Application certificate that the project is configured to sign with, including its private key, in your Keychain.

For the build procedure, see Build from source.