# 1636 Orbstack D7316136

> OrbStack - Fast, Lightweight Docker Desktop and Linux VM Alternative

- Skill: `tools-only/1636-orbstack-d7316136` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/1636-orbstack-d7316136`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/1636-orbstack-d7316136/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/tools-only/1636-orbstack-d7316136

---

# OrbStack - Fast, Lightweight Docker Desktop and Linux VM Alternative

**Research Date**: January 31, 2026
**Source URL**: <https://orbstack.dev>
**Documentation**: <https://docs.orbstack.dev>
**GitHub Organization**: <https://github.com/orbstack>
**Twitter**: <https://twitter.com/orbstack>
**Discord**: <https://discord.gg/Tfjyd5N5Eq>
**Version at Research**: v2.0.5 (November 2024)
**License**: Proprietary (Free for personal/educational use; commercial license required for business use)

---

## Overview

OrbStack is a fast, lightweight, and efficient Docker Desktop alternative for macOS that also supports full Linux virtual machines and Kubernetes. Built with a native Swift app and purpose-built services in Swift, Go, Rust, and C, OrbStack provides 2-second startup times, near-zero idle CPU usage, and dynamic memory allocation that returns unused memory to macOS.

**Core Value Proposition**: Replace Docker Desktop with a faster, lighter, more efficient solution that also offers full Linux machine support, Kubernetes, and seamless macOS integration without the Electron overhead.

---

## Problem Addressed

| Problem                                                    | How OrbStack Solves It                                |
| ---------------------------------------------------------- | ----------------------------------------------------- |
| Docker Desktop is slow to start and resource-heavy         | 2-second startup, 0.1% idle CPU, dynamic memory       |
| Docker Desktop uses Electron and consumes excessive memory | Native Swift macOS app with minimal footprint         |
| Memory allocated to Docker VM is not returned to macOS     | Fully dynamic memory allocation returns unused memory |
| Need for separate Linux VM tools (UTM, Parallels)          | Integrated Linux machine support with 15 distros      |
| Complex Kubernetes setup for local development             | Built-in single-node Kubernetes cluster               |
| Docker Desktop licensing costs for enterprise              | Competitive pricing with per-user licensing           |
| File sharing between macOS and containers is slow          | Optimized 2-way file sharing with bind mounts         |
| Network complexity with VPNs and DNS                       | VPN compatibility, IPv6, ICMP, DNS integration        |

---

## Key Statistics (as of January 31, 2026)

| Metric           | Value                              |
| ---------------- | ---------------------------------- |
| Primary Language | Swift, Go, Rust, C                 |
| Platform         | macOS only (Intel + Apple Silicon) |
| Created          | 2022                               |
| Current Version  | v2.0.5 (November 2024)             |
| Linux Distros    | 15 supported                       |
| Kubernetes       | Single-node cluster included       |
| Company          | Orbital Labs, LLC                  |

---

## Key Features

### 1. Lightning Fast Performance

- **2-second startup**: From cold to running containers in 2 seconds
- **Fast networking**: Optimized network stack with benchmarked improvements
- **Rosetta x86 emulation**: Run x86/amd64 containers on Apple Silicon via Rosetta 2
- **Optimized file I/O**: Efficient bind mounts and volume handling

### 2. Extreme Efficiency

- **0.1% idle CPU**: Often drops to 0% when no workloads running
- **Dynamic memory**: Memory allocated on-demand and returned to macOS when unused
- **Minimal disk footprint**: Fresh install uses less than 10 MB
- **Native macOS app**: No Electron overhead, battery-friendly
- **Dozens of Linux machines**: Run many VMs without resource strain

### 3. Docker Compatibility

- **Drop-in replacement**: Use existing `docker` and `docker-compose` commands
- **Full Docker API**: Works with all Docker tools and extensions
- **Bind mounts**: Native macOS file system access
- **Host networking**: Full support including `--network host`
- **Volume file access**: Access container volumes directly from Finder
- **Image file access**: Inspect image contents natively

### 4. Kubernetes Integration

- **Single-node cluster**: Lightweight Kubernetes optimized for development
- **Shared container engine**: Built images immediately available for pods
- **Service access**: NodePort, ClusterIP, and LoadBalancer accessible from Mac
- **Wildcard domains**: `*.k8s.orb.local` for easy service access
- **cluster.local DNS**: Access `service.namespace.svc.cluster.local` from Mac
- **GUI for pods/services**: Visual management in the app

### 5. Linux Machine Support

- **15 distributions**: Ubuntu, Debian, Fedora, Arch, Alpine, CentOS, Rocky, Alma, Oracle, openSUSE, Kali, NixOS, Gentoo, Devuan, Void
- **Instant SSH**: Automatic SSH configuration, no manual setup
- **2-way file sharing**: Access Linux files from Mac and vice versa
- **CLI integration**: Run Mac commands from Linux (`mac open .`) and Linux commands from Mac
- **Cloud-init**: Automated machine provisioning via cloud-init
- **x86 emulation**: Run x86 Linux machines on Apple Silicon

### 6. Network Features

- **Zero-config domains**: Containers accessible at `container.orb.local`
- **Automatic HTTPS**: TLS certificates for local development
- **IPv6 support**: Full IPv6 networking
- **ICMP support**: `ping` and `traceroute` work correctly
- **VPN compatibility**: Works alongside VPN software
- **macOS DNS integration**: Resolves container domains system-wide
- **localhost forwarding**: Port forwarding to localhost
- **HTTP(S)/SOCKS proxy**: Proxy configuration support

### 7. User Experience

- **Menu bar app**: Quick access to containers and machines
- **Debug Shell**: Inspect container internals easily
- **Native files access**: Browse container/image/volume files in Finder
- **No admin required**: Install and run without admin privileges
- **Auto-update**: Automatic updates via GUI
- **Simple UI**: Clean, minimal interface

### 8. Command Line & CI

- **`orb` CLI**: Full control from terminal
- **Headless mode**: Run without GUI for CI/automation
- **`orbctl`**: Low-level control commands
- **`orb config`**: Programmatic configuration

---

## Technical Architecture

```text
macOS Host
    │
    ▼
┌─────────────────────────────────────────────────────────────┐
│                     OrbStack App (Swift)                      │
│  ┌─────────────────────────────────────────────────────────┐ │
│  │                  Purpose-Built Services                   │ │
│  │  - Networking (custom stack)                             │ │
│  │  - File sharing (optimized)                              │ │
│  │  - DNS resolution                                         │ │
│  │  - SSH management                                         │ │
│  │  Languages: Swift, Go, Rust, C                           │ │
│  └─────────────────────────────────────────────────────────┘ │
│                           │                                   │
│                           ▼                                   │
│  ┌─────────────────────────────────────────────────────────┐ │
│  │           Lightweight Linux VM (Shared Kernel)            │ │
│  │  - Similar architecture to WSL 2                         │ │
│  │  - Low-level VM optimizations                            │ │
│  │  - Dynamic resource allocation                           │ │
│  └─────────────────────────────────────────────────────────┘ │
│         │                    │                    │          │
│         ▼                    ▼                    ▼          │
│  ┌───────────┐      ┌───────────────┐     ┌──────────────┐  │
│  │  Docker   │      │   Kubernetes  │     │    Linux     │  │
│  │  Engine   │      │   (k3s-based) │     │   Machines   │  │
│  │           │      │               │     │  (15 distros)│  │
│  └───────────┘      └───────────────┘     └──────────────┘  │
└─────────────────────────────────────────────────────────────┘
    │
    ▼
macOS Integration
  - Zero-config domains (*.orb.local)
  - Finder file access
  - SSH agent forwarding
  - VPN compatibility
```

---

## Installation & Usage

### Installation Options

```bash
# Homebrew (recommended)
brew install orbstack

# Direct download
# Visit https://orbstack.dev and download the app
```

### Basic Docker Usage

```bash
# Start OrbStack
orb start

# Run containers (standard Docker commands work)
docker run -p 80:80 nginx
docker compose up -d

# Stop OrbStack
orb stop
```

### Linux Machine Usage

```bash
# Create Ubuntu machine
orb create ubuntu

# Create specific version
orb create ubuntu:jammy

# Create Fedora machine
orb create fedora:39

# List machines
orb list

# SSH into machine (automatic)
ssh myubuntu@orb

# Or use orb command
orb shell ubuntu
```

### Kubernetes Usage

```bash
# Enable Kubernetes in app settings
# Use kubectl as normal
kubectl get pods

# Access services at *.k8s.orb.local
curl http://myservice.default.svc.k8s.orb.local
```

### Configuration

```bash
# View configuration
orb config

# Set configuration
orb config set setup.use_admin false

# Restart Docker engine
orb restart docker
```

---

## Benchmarks (vs Docker Desktop)

**Testing conducted August 2023 with OrbStack v0.17.0 vs Docker Desktop v4.22.0 on M1 Max MacBook Pro**

| Benchmark          | OrbStack             | Docker Desktop | Improvement |
| ------------------ | -------------------- | -------------- | ----------- |
| Open edX build     | Significantly faster | Baseline       | Major       |
| Idle CPU           | ~0.1%                | Higher         | Substantial |
| Memory (idle)      | Returns to macOS     | Retained       | Significant |
| Startup time       | ~2 seconds           | Longer         | Major       |
| Disk usage (fresh) | <10 MB               | Larger         | Significant |

_Note: Results are workload-dependent. See <https://docs.orbstack.dev/benchmarks> for full methodology._

---

## Licensing Model

| Use Case              | License Required | Cost                  |
| --------------------- | ---------------- | --------------------- |
| Personal/hobby        | No               | Free                  |
| Educational (student) | No               | Free                  |
| Commercial/business   | Yes              | Per-user subscription |
| Freelance             | Yes              | Per-user subscription |
| Non-profit entity     | Yes              | Per-user subscription |
| Revenue >$10K/year    | Yes              | Per-user subscription |

- **Per-user licensing**: Up to 5 devices per user
- **14-day trial**: Free trial for commercial evaluation
- **Enterprise SSO**: Available for organizations
- **Central user management**: Team administration features

---

## Comparison with Alternatives

| Feature             | OrbStack         | Docker Desktop | Colima       | UTM    |
| ------------------- | ---------------- | -------------- | ------------ | ------ |
| Docker              | Yes              | Yes            | Yes          | Manual |
| Linux VMs           | Yes (15 distros) | No             | No           | Yes    |
| Kubernetes          | Yes              | Yes            | Yes (manual) | No     |
| Native macOS app    | Yes              | No (Electron)  | CLI only     | Yes    |
| Memory efficiency   | Excellent        | Poor           | Good         | Good   |
| Startup speed       | 2 seconds        | Slower         | Moderate     | Slower |
| Zero-config domains | Yes              | No             | No           | No     |
| Price (personal)    | Free             | Free           | Free         | Free   |
| Commercial license  | Required         | Required       | Free         | Free   |

---

## Relevance to Claude Code Development

### Direct Applications

1. **Development Environment**: OrbStack provides an efficient local container environment for running MCP servers, test databases, and development services
2. **CI/CD Testing**: Headless mode allows automated testing of containerized services
3. **Multi-distro Testing**: Test skills and agents across 15 Linux distributions without separate VM tools
4. **Resource Efficiency**: Run development containers without impacting Claude Code's performance due to minimal resource overhead

### Patterns Worth Adopting

1. **Dynamic Resource Allocation**: OrbStack's memory management pattern (allocate on demand, return when unused) is applicable to agent resource management
2. **Zero-config Networking**: Container domain pattern (`*.orb.local`) simplifies service discovery - applicable to MCP server management
3. **Vertical Integration**: Purpose-built components working together (like OrbStack's services) yield better results than off-the-shelf assembly
4. **Native Platform Integration**: Swift app with macOS integration demonstrates value of platform-native tooling

### Integration Opportunities

1. **MCP Server Hosting**: Run MCP servers in OrbStack containers with automatic domain resolution
2. **Test Environment**: Use Linux machines for testing agent behavior across distributions
3. **Kubernetes Skills**: Leverage OrbStack's K8s for developing and testing Kubernetes-related skills
4. **Docker Compose Workflows**: Skills that generate Docker Compose configurations can be tested directly in OrbStack

### Key Insight

OrbStack demonstrates that significant performance improvements come from purpose-built solutions with deep integration rather than layering existing tools. This principle applies to Claude Code: custom-designed skills and workflows outperform generic tool assemblies.

---

## References

1. **Official Website**: <https://orbstack.dev> (accessed 2026-01-31)
2. **Documentation**: <https://docs.orbstack.dev> (accessed 2026-01-31)
3. **Features Overview**: <https://docs.orbstack.dev/features> (accessed 2026-01-31)
4. **Architecture**: <https://docs.orbstack.dev/architecture> (accessed 2026-01-31)
5. **Benchmarks**: <https://docs.orbstack.dev/benchmarks> (accessed 2026-01-31)
6. **Efficiency**: <https://docs.orbstack.dev/efficiency> (accessed 2026-01-31)
7. **Docker Desktop Comparison**: <https://docs.orbstack.dev/compare/docker-desktop> (accessed 2026-01-31)
8. **Licensing**: <https://docs.orbstack.dev/licensing> (accessed 2026-01-31)
9. **Release Notes**: <https://docs.orbstack.dev/release-notes> (accessed 2026-01-31)
10. **Linux Distributions**: <https://docs.orbstack.dev/machines/distros> (accessed 2026-01-31)
11. **Kubernetes**: <https://docs.orbstack.dev/kubernetes/> (accessed 2026-01-31)
12. **Command Line Usage**: <https://docs.orbstack.dev/headless> (accessed 2026-01-31)

---

## Related Tools

| Tool                                                              | Relationship                                               |
| ----------------------------------------------------------------- | ---------------------------------------------------------- |
| [Docker Desktop](https://www.docker.com/products/docker-desktop/) | Primary competitor - OrbStack is a drop-in replacement     |
| [Colima](https://github.com/abiosoft/colima)                      | Open-source Docker alternative using Lima                  |
| [Lima](https://github.com/lima-vm/lima)                           | Linux VMs on macOS (underlying tech for some alternatives) |
| [UTM](https://mac.getutm.app/)                                    | Full virtualization for macOS (not Docker-focused)         |
| [Rancher Desktop](https://rancherdesktop.io/)                     | Open-source Kubernetes/Docker alternative                  |
| [Podman Desktop](https://podman-desktop.io/)                      | Daemonless container engine alternative                    |

---

## Freshness Tracking

| Field                   | Value                         |
| ----------------------- | ----------------------------- |
| Last Verified           | 2026-01-31                    |
| Version at Verification | v2.0.5                        |
| Platform                | macOS (Intel + Apple Silicon) |
| Next Review Recommended | 2026-04-30 (3 months)         |

**Change Detection Indicators**:

- Monitor release notes at <https://docs.orbstack.dev/release-notes> for version changes
- Check for new Linux distribution support
- Track Kubernetes version updates
- Review pricing changes at <https://orbstack.dev/pricing>
- Watch for Windows support (currently macOS only)
- Monitor feature parity with Docker Desktop updates

