Skip the cutscene

Dungeon dictionary (glossary)

This glossary defines terms that have a specific meaning in Pomme. The System uses these words constantly and assumes you know them, Crawler. You don’t. That’s fine. Nobody does at first. The viewers enjoy the blank stare, but the System is contractually obligated to explain.

AMFI

Apple Mobile File Integrity, the macOS subsystem that enforces code-signing policy. Pomme changes AMFI through a VM’s LocalPolicy and boot arguments. See Change SIP and AMFI. It’s a protection, not an obstacle, which is why the System makes you work to turn it off.

Automatic login

A macOS setting that signs a user in at startup without a password prompt. Pomme turns it on for the pomme owner account when it prepares a fresh VM for a security workflow.

Background helper

The per-VM host process that runs a VM through Virtualization.framework. The pomme command talks to it through a Unix socket. Also called the helper. It does all the heavy lifting and never gets a fan segment.

Boot mode

How a VM starts: normal starts macOS, and recovery starts macOS Recovery. After creation, none leaves the VM stopped. Choose wisely, or at least choose.

Durable terminal session

An interactive shell or program in a guest pseudo-terminal that keeps running when you detach. You can reattach later and replay its output. See Use durable terminal sessions. Unlike Crawlers, these survive when you walk away.

Executable digest

The SHA-256 hash of a guest agent executable. Pomme pins each VM to the digest it installed, or to the digest that pomme agent update last installed, and verifies it on every connection. No disguises get past the door.

Experimental attempt

Creation or Recovery navigation for a macOS version or build that has no reviewed Recovery profile. Pomme allows it with a warning. The System calls this “bold.” See Supported macOS versions.

Final state

The run state that a workflow leaves a VM in when it finishes, such as previous, stopped, or normal. Security commands take it as --final-state.

First-boot provisioning

The macOS 27 Virtualization feature that creates a user account and turns on services the first time a guest starts. Pomme uses it to install the guest agent when both the host and the guest run macOS 27.

Guest

The macOS installation that runs inside a VM. In jokes, “the box.”

Guest agent

The Pomme service that runs in a guest and carries out host requests, such as running programs and transferring files. See Guest agent.

Host

The Apple silicon Mac that runs Pomme and its VMs. The arena, basically.

Journal

A file in a VM bundle where Pomme records each step of a long-running workflow before and after it happens. Pomme uses journals to resume creation and security workflows safely. See Durable creation and journals. It’s the dungeon’s black box recorder, and it’s why a death mid-workflow is usually a second life instead of a funeral.

LocalPolicy

The per-installation security policy that controls how an Apple silicon Mac or VM starts macOS, including its SIP and AMFI settings.

MDM

Mobile device management. Pomme can enroll a VM with a configuration profile from an MDM server. See Enroll a VM in MDM.

Owner account

The pomme administrator account that Pomme creates in a fresh VM when a security workflow needs one. Pomme stores its generated password in the host’s login Keychain. Not on a sticky note. The System checked.

Provisioned template

A template that already contains the owner account, with SIP turned off and the AMFI override on. VMs cloned from it can start MDM enrollment immediately. See Use templates. It arrives pre-softened, so the clones skip straight to the paperwork.

Recovery

The macOS Recovery environment. Pomme uses it to install the guest agent and to change SIP and AMFI.

Recovery session

A temporary, authenticated Pomme service that runs in Recovery for one request and is removed when the request ends. In and out. No loitering.

Restore image

An IPSW file that contains a macOS release for Apple silicon. Pomme installs macOS in a VM from a restore image.

Reviewed profile

A Recovery navigation profile that has passed Pomme’s review for one exact macOS version and build.

SIP

System Integrity Protection, the macOS feature that protects system files and processes. See Change SIP and AMFI. The dungeon’s load-bearing wall. Knock it down only on purpose.

Snapshot

A named copy of a VM’s saved machine state that you can restore later. See Save and restore snapshots. A save point. Not a backup. The System will keep saying this until it sticks.

Template

An installed macOS disk image, auxiliary storage, and hardware model that Pomme clones to create VMs quickly. See Use templates.

VM bundle

The directory in Pomme’s data directory that holds one VM’s disk image, identity, metadata, and journals. See Files and paths.

VSOCK

The virtual socket transport between a host and a VM. The guest agent and Recovery session listen on VSOCK ports. The secret tunnel between the arena and the box.