macOS Support

Tormoni uses Hypervisor.framework on macOS ARM64 for hardware virtualization.

The same verbs and tools work on macOS, but with a few platform-specific differences.

Requirements and Build Process

• Hypervisor entitlement: Hypervisor.framework refuses a process without the com.apple.security.hypervisor entitlement. The build process handles this: cargo xtask sign applies it.
• Re-signing: A signature does not reliably outlive the next cargo build. You must re-sign the binary after building.
• App bundle: cargo xtask bundle assembles Tormoni.app from the built pair (the CLI and the GUI app).

Limitations

macOS’s libkrun port has two notable differences compared to Linux:

1. It builds neither the --sound card nor the guest input backend.
2. A display is viewed in tormoni-app rather than a window of the helper’s own.