Installation

Lumier needs two things: Docker and Lume.

1. Install Docker

Verify it's running:

docker --version
# Docker version 24.0.0, build ...

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"

Verify the Lume service is running:

curl http://localhost:7777/lume/vms
# Should return [] or a list of VMs

Lume runs as a background service on port 7777. Lumier connects to this service to create and manage VMs.

Pull and run Lumier:

docker run -it --rm \
  -p 8006:8006 \
  -e VM_NAME=test-vm \
  -e VERSION=ghcr.io/trycua/macos-sequoia-cua:latest \
  trycua/lumier:latest

Open http://localhost:8006 in your browser. You should see a macOS desktop loading.

"Cannot connect to Lume service" — The Lume background service isn't running. Start it:

lume serve

Or check if the daemon is loaded:

launchctl list | grep com.trycua.lume_daemon

Port 7777 in use — Another service is using the port. Either stop that service or reinstall Lume with a different port:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)" -- --port 7778

Then update your Lumier commands to use the new port via the LUME_PORT environment variable.

Was this page helpful?