Skip the cutscene

pomme firmware

SYSTEM NOTICE: The System couldn't be bothered to narrate this page. Enjoy the boring version, Crawler. The facts are the same either way.

Inspect and repair the boot firmware of a VM.

pomme firmware SUBCOMMAND

Show a VM’s boot firmware and whether a guest update left the VM short of memory.

Pomme reads the firmware from the auxiliary storage of the VM, so this works while the VM is stopped. While the VM runs normal macOS with a connected Pomme agent, Pomme also asks the guest for its macOS version and usable memory, and bases the diagnosis on them. The diagnosis is affected, likely-affected, not-affected, or unknown.

pomme firmware inspect [NAMES ...] [--json] [--format FORMAT] [--debug] [--progress PROGRESS]
Argument Description
NAMES VM names. Uses POMME_VM_NAME when omitted.

This command also accepts the common flags.

Restore the boot firmware that a VM was installed with.

Use this when pomme firmware inspect reports incompatible-update for a VM that runs macOS 26 or earlier: a guest update to macOS 26.7 or 15.8 installed the macOS 27 boot firmware, which leaves the guest about 1.75 GB of memory. The VM must be stopped. Pomme saves a copy of the AuxiliaryStorage file in the FirmwareBackups folder of the VM bundle, then copies the firmware that the VM was installed with over the firmware that the update installed. When the firmware needs no repair, Pomme changes nothing. Never use it on a VM that you upgraded to macOS 27 in the guest.

pomme firmware repair [NAME] [--force] [--json] [--format FORMAT] [--debug] [--progress PROGRESS]
Argument Description
NAME VM name. Uses POMME_VM_NAME when omitted.
Flag Description
-f, --force Repair without prompting.

This command also accepts the common flags.


Generated from the help text of pomme 0.5.0 (34403a8-dirty).