Files
wehub-resource-sync 91e75e620b
CI: cua-driver distro-compat matrix / Resolve release version (push) Waiting to run
CI: cua-driver distro-compat matrix / debian:12 (glibc 2.36) (push) Blocked by required conditions
CI: cua-driver distro-compat matrix / fedora:41 (glibc 2.40) (push) Blocked by required conditions
CI: cua-driver distro-compat matrix / rockylinux:9 (glibc 2.34) (push) Blocked by required conditions
CI: cua-driver distro-compat matrix / ubuntu:22.04 (glibc 2.35) (push) Blocked by required conditions
CI: cua-driver distro-compat matrix / ubuntu:24.04 (glibc 2.39) (push) Blocked by required conditions
CI: cua-driver distro-compat matrix / Distro compat summary (push) Blocked by required conditions
CI: Nix Linux Rust source / Nix / compositor build (push) Waiting to run
CI: Nix Linux Rust source / Nix / driver package (push) Waiting to run
CI: Nix Linux Rust source / Nix / Rust unit tests (push) Waiting to run
CI: Rust Linux unit / Rust Linux unit and compile (push) Waiting to run
CI: Rust Windows unit / Rust Windows unit and compile (push) Waiting to run
CI: SPDX Headers / Check SPDX headers (warn-only) (push) Waiting to run
CD: Docs MCP Server / build (linux/amd64) (push) Waiting to run
CD: Docs MCP Server / build (linux/arm64) (push) Waiting to run
CD: Docs MCP Server / merge (push) Blocked by required conditions
chore: import upstream snapshot with attribution
2026-07-13 13:03:19 +08:00
..

Lume

CLI and framework for macOS and Linux VMs using Apple Virtualization Framework.

Documentation - Installation, guides, and API reference.

Vanilla macOS VMs

Create a fresh macOS VM from an Apple restore image with the offline unattended setup enabled:

lume create macos-tahoe --ipsw ~/Downloads/macos-tahoe.ipsw --unattended tahoe
lume run macos-tahoe

The built-in sequoia and tahoe presets configure the installed guest without GUI automation. They create the lume user, enable SSH, configure autologin, and disable sleep and screen locking. The default SSH credentials are lume / lume.

Tahoe is E2E verified from a local IPSW. Sequoia can still present the Accessibility step of Setup Assistant on its first display boot; this is tracked in #2155.

To use the other built-in preset, replace tahoe with sequoia in the --unattended option and choose a matching VM name.

Optional dependencies

The lume sip command uses vncdotool to control macOS Recovery over VNC. Install it only if you need to enable or disable SIP:

pip3 install vncdotool

Other Lume commands do not require this package.