trycua--cua
wehub-resource-sync
91e75e620b
CI: cua-driver distro-compat matrix / debian:12 (glibc 2.36) (push) Has been cancelled
CI: SPDX Headers / Check SPDX headers (warn-only) (push) Has been cancelled
CD: Docs MCP Server / build (linux/amd64) (push) Has been cancelled
CD: Docs MCP Server / build (linux/arm64) (push) Has been cancelled
CD: Docs MCP Server / merge (push) Has been cancelled
CI: cua-driver distro-compat matrix / Resolve release version (push) Has been cancelled
CI: cua-driver distro-compat matrix / fedora:41 (glibc 2.40) (push) Has been cancelled
CI: cua-driver distro-compat matrix / rockylinux:9 (glibc 2.34) (push) Has been cancelled
CI: cua-driver distro-compat matrix / ubuntu:22.04 (glibc 2.35) (push) Has been cancelled
CI: cua-driver distro-compat matrix / ubuntu:24.04 (glibc 2.39) (push) Has been cancelled
CI: cua-driver distro-compat matrix / Distro compat summary (push) Has been cancelled
CI: Rust Linux unit / Rust Linux unit and compile (push) Has been cancelled
CI: Rust Windows unit / Rust Windows unit and compile (push) Has been cancelled
CI: Nix Linux Rust source / Nix / compositor build (push) Has been cancelled
CI: Nix Linux Rust source / Nix / driver package (push) Has been cancelled
CI: Nix Linux Rust source / Nix / Rust unit tests (push) Has been cancelled
39 行
1.2 KiB
Markdown
39 行
1.2 KiB
Markdown
# Lume
|
|
|
|
CLI and framework for macOS and Linux VMs using Apple Virtualization Framework.
|
|
|
|
**[Documentation](https://cua.ai/docs/lume)** - Installation, guides, and API reference.
|
|
|
|
## Vanilla macOS VMs
|
|
|
|
Create a fresh macOS VM from an Apple restore image with the offline unattended
|
|
setup enabled:
|
|
|
|
```bash
|
|
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](https://github.com/trycua/cua/issues/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:
|
|
|
|
```bash
|
|
pip3 install vncdotool
|
|
```
|
|
|
|
Other Lume commands do not require this package.
|