lume runtime, which uses
Lume. Use it to build and test software that
needs macOS, such as iOS or macOS apps.
Requirements
- A Mac with Apple silicon. Intel Macs and Linux can’t run macOS rigs.
- About 50 GB of free disk.
- A BYOC host on that Mac.
Turn on macOS rigs
On a new host, answer yes to macOS VMs whenamika-hostd setup asks. On a
host that’s already set up, run:
- Installs Lume 0.6.1 into
~/.local/bin, if it’s missing. Nosudo. - Turns on the
lumeruntime in the config file. - Adds the
macos-coderpreset, which starts theamika-macos-coderimage.
Wait for the image
The daemon builds the macOS image in the background when it starts. Nothing waits for it, but it takes 30 minutes or more:- Lume downloads a macOS restore image from Apple (about 20 GB).
- Lume installs macOS into a base VM,
amika-macos-base. - The daemon copies the base VM and installs Amika’s tools into the copy,
amika-macos-coder. - The daemon keeps the restore image in
~/.cache/amika-hostd/macos/. If the build fails, or the base VM is deleted later, the next build skips the 20 GB download. It also keeps the base VM, so a new image starts from it.
amika-hostd up or
amika-hostd reload tries again.
Create a macOS rig
- CLI
- Web UI
- TypeScript
- HTTP API
Limits
- Two running macOS rigs per Mac. Apple’s license allows two macOS VMs at a time. A third start is refused with “host is full”.
- The disk is the image’s. A size that asks for less disk than the image has is refused.
- No snapshots. You can’t snapshot a macOS rig.
Remove macOS rigs
To stop offering macOS rigs, delete the rigs, then run:~/.lume). The restore
image stays in ~/.cache/amika-hostd/macos/. To delete them,
uninstall the daemon. Type
remove macos images and remove macos restore image when it asks. Lume
itself stays installed, since other tools can use it.