Quickstart

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 supported restore image (or pass a local .ipsw; lume ipsw prints the URL). The tahoe preset prepares the guest offline: user lume with password lume, SSH, autologin, no sleep or screen lock. Creation boots once, checks SSH and leaves the VM 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 using the VM for anything sensitive.

Clean up#

lume stop macos-tahoe
lume delete macos-tahoe

Next#

• Manage VMs
• Drive Lume from scripts and agents
• CLI reference