Getting Started with OrbStack on macOS

Replacing Docker Desktop with OrbStack.

macos devops docker kubernetes orbstack

For years Docker Desktop was the only real choice on macOS. It cost you. Battery drain. Loud fans. A filesystem that crawled.

Enter OrbStack. A native Mac app. Lighter, faster, and it behaves like it belongs on the machine. It is more than a Docker replacement. It runs Linux machines and Kubernetes clusters too.

This guide sticks to the orb CLI.

1. Installation

Homebrew is the quickest way in. Open a terminal and run:

brew install orbstack

OrbStack sets itself up on first launch. It installs the orb, docker and kubectl command-line tools for you.

2. Running a Linux Virtual Machine

This is where the orb CLI shines. Containers go through docker. Linux machines go through orb.

Create a Machine

Spin up an Ubuntu box. Ubuntu is the default.

# Syntax: orb create [distro] [name]
orb create ubuntu sandbox

Access the Machine

No ssh keys. No config files. The orb CLI handles the login:

# Log into the default user
orb -m sandbox

3. Running a Container

Note: orb runs the engine. You still run containers with docker. OrbStack drops in where the Docker engine was, so your old commands work unchanged.

Run a Web Server

Let’s run a simple Nginx container.

docker run -d --name my-web nginx

Magic Domains

This is OrbStack’s killer feature. Forget localhost:8080. Every running container gets a domain named after it.

Open your browser and visit: http://my-web.orb.local

It resolves straight to your container. No port clashes. No localhost guesswork.

4. Running a Kubernetes Cluster

orb turns the cluster on and off. You still deploy with kubectl.

Enable Kubernetes via CLI

K8s ships off, to save resources. Turn it on from the terminal:

# Enable and start the Kubernetes cluster
orb start k8s

Note: It may take a few moments for the cluster to spin up.

Deploy a Pod

Once the cluster is up, OrbStack sets your context for you.

# Create a pod
kubectl run k8s-demo --image=nginx

# Wait for it to start
kubectl get pods -w

Exposing Services

Create a Service of type LoadBalancer. OrbStack hands it an IP your Mac can reach, right away.

# Expose the pod
kubectl expose pod k8s-demo --type=LoadBalancer --port=80

# Get the External IP
kubectl get svc k8s-demo

5. Cleanup

Finished exploring? OrbStack is fast enough that tearing it down costs you nothing. Here is how to clear what we made.

Remove the Linux VM

orb delete sandbox

Remove the Container

docker rm -f my-web

Disable the Kubernetes Cluster

orb stop k8s
orb config set k8s.enabled false

Summary

You swapped a heavy virtualization stack for one native app.

  • Infrastructure Management: Use orb (e.g., orb create, orb restart, orb list).
  • Container Workloads: Use docker (standard CLI).
  • Cluster Workloads: Use kubectl (standard CLI).