Cua Docs

Install and run Lume

Install Lume, Cua's local Apple Silicon VM manager for macOS and Linux guests.

Lume is Cua's local VM manager for Apple Silicon Macs. Use it when you want to create, run, or serve macOS and Linux VMs on your own machine. It can provide local VM substrate for Cua workflows, but the primary product choice is still Cua Driver for an existing machine or Cua Sandbox for a fresh isolated desktop.

Requirements#

  • Apple Silicon Mac (M1, M2, M3, etc.)
  • macOS 13.0 or later
  • At least 8GB of RAM (16GB recommended)
  • At least 50GB of free disk space

Install Lume#

Install with a single command:

/bin/bash -c "$(curl -fsSL https://cua.ai/lume/install.sh)"

Verify the install#

lume --version

Update Lume#

Check whether a newer release is available:

lume check-update

Apply an available update:

lume update --apply

The installer no longer creates scheduled auto-updaters. Older lume-update cron jobs and LaunchAgents are removed the next time the installer runs.

Manual installation#

You can also download the lume.pkg.tar.gz archive from the latest release, extract it, and install the package manually.

Next steps#