Quickstart

Install Lume, create a vanilla macOS Tahoe VM from an Apple restore image, and connect over SSH.

Install Lume, create a macOS Tahoe VM straight from Apple's restore image, and SSH into it.

Prerequisites#

  • An Apple silicon Mac on macOS 13 or later.
  • 8 GB free memory and about 50 GB free disk.

Run#

/bin/bash -c "$(curl -fsSL https://cua.ai/lume/install.sh)"
lume --version
lume create macos-tahoe --ipsw latest --unattended tahoe

--ipsw latest downloads the newest restore image Lume supports. To use a file you already have, pass its .ipsw path; lume ipsw prints the download URL. The tahoe preset sets up the guest without clicking through Setup Assistant: user lume with password lume, SSH on, autologin, and no sleep or screen lock. Lume boots the VM once, checks that SSH answers, and leaves it stopped.

lume run macos-tahoe

Result#

The VM's desktop opens in Lume's viewer. From another terminal:

lume ssh macos-tahoe 'sw_vers; id -un'

prints the guest's macOS version and lume. Change the password before you use the VM for anything sensitive.

lume ls listing local macOS VMs

Clean up#

lume stop macos-tahoe
lume delete macos-tahoe

Next#