LumeGuideAdvanced
Lumier
Docker interface for running macOS virtual machines with Lume
Lumier wraps Lume in a Docker container, giving you browser-based access to macOS VMs with zero configuration.
docker run -it --rm \
-p 8006:8006 \
-e VM_NAME=my-vm \
-e VERSION=ghcr.io/trycua/macos-sequoia-cua:latest \
trycua/lumier:latestOpen http://localhost:8006 in your browser—you'll see a macOS desktop.
When to use Lumier vs Lume directly
| Use Lumier when... | Use Lume directly when... |
|---|---|
| You want browser-based VNC access | You prefer native VNC clients |
| You're distributing VM environments | You're running locally for development |
| You want Docker Compose orchestration | You need maximum performance |
| You're building Docker-based workflows | You want full CLI control |
How it works
Docker is the delivery mechanism, not an isolation layer. Lumier connects to the Lume service on your host Mac to create real VMs using Apple's Virtualization Framework.
┌─────────────────────────────────────┐
│ Docker Container │
│ ┌─────────────────────────────┐ │
│ │ Lumier + noVNC server │ │
│ └──────────────┬──────────────┘ │
└─────────────────┼───────────────────┘
│ connects to
┌─────────────────▼───────────────────┐
│ Lume service (port 7777) │
│ on host Mac │
└─────────────────┬───────────────────┘
│ creates
┌─────────────────▼───────────────────┐
│ macOS VM (Virtualization.framework) │
└─────────────────────────────────────┘The Docker container provides:
- noVNC server for browser access
- Environment variable configuration
- Lifecycle hooks for automation
The actual VM runs natively on your Mac with hardware acceleration.
Get started
- Install prerequisites — Docker and Lume
- Run with Docker — Basic usage and persistent storage
- Use Docker Compose — Multi-container setups
- Build from source — Customize the container
Was this page helpful?