Running Docker and Linux Machines on macOS with OrbStack

Docker Desktop isn’t the only way to run Docker on macOS. I recently moved my dev machine to OrbStack — it starts fast, keeps the fan quiet, and the battery lasts. This post is a note on where it shines and how to start.

Correction (2 November 2026, 18:45 Taipei): automatic migration is limited to Docker Desktop; the Compose example now uses the mysql_8.3 directory; USB passthrough is marked as added in version 2.2.0 (June 2026). Suggested by Codex (gpt-6-astra), checked by Claude.

Why move off Docker Desktop

Under the hood, Docker Desktop on macOS is a Linux VM: slow to boot, a steady drain on CPU and memory, noticeably worse on laptop battery, and a licensing concern for larger orgs. You just want to docker run something, yet you’re keeping a heavy VM alive.

OrbStack targets exactly that: the same Docker engine, but lighter, faster, and easier on the battery.

What OrbStack is

It bills itself as “a fast, light, and simple way to run containers and Linux machines”, folding the roles of Docker Desktop and WSL into one app. A few things you actually feel:

It starts in about 2 seconds (the official figure), is written in native Swift, and keeps CPU / disk / memory low and battery-friendly.
It’s drop-in compatible with the docker / docker compose CLI; the engine changes, your commands don’t.
It auto-migrates containers, volumes and images from Docker Desktop, and moving from Colima only takes opening OrbStack, so the transition is nearly painless.

Running Docker

After installing (download from orbstack.dev, or brew install --cask orbstack), keep the app running and docker just works:

# reuse existing compose templates — clone, tweak, run
git clone https://github.com/yshengliao/docker-compose-templates
cd docker-compose-templates/mysql_8.3
docker compose up -d

Two conveniences: each container automatically gets a domain like <container>.orb.local, so you don’t juggle port mappings; and volumes and images open natively in Finder — file access is first-class.

Running Linux machines (VMs)

OrbStack isn’t only Docker; it also spins up full Linux distros as throwaway dev sandboxes:

orb create ubuntu        # create an Ubuntu machine
orb                      # drop into the default machine's shell (or SSH in)

The machine shares files both ways with macOS, and there’s x86 emulation (Rosetta) for amd64 binaries. When you need “a real Linux box” to test something, it’s far less hassle than standing up a traditional VM. If you need Kubernetes, you enable it in settings — nothing extra to install.

What makes it pleasant

Automatic *.orb.local domains, two-way file sharing, USB passthrough (added in version 2.2.0, June 2026), and built-in SSH / VPN.
A menu-bar toggle plus a CLI / headless mode that works in CI.
The fan and battery difference is the most noticeable part: leaving containers running no longer pins the CPU.

Notes

OrbStack is a lightweight Docker Desktop alternative: fast to start, light on resources and battery, fully compatible with the docker CLI.
One app manages containers, Linux machines, and Kubernetes, and it auto-migrates from Docker Desktop.
Containers get *.orb.local domains automatically and volumes open natively in Finder; smooth day-to-day.
When you want a real Linux box, orb create is a one-liner, with x86 emulation included.
Pair it with the existing docker-compose-templates to bring services up: clone, tweak, docker compose up.