Colima — Container Runtimes on macOS & Linux in a Lima VM

Introduction

Colima (Containers on Lima) is a lightweight wrapper around the Lima virtual-machine project. It boots a fast QEMU/Virtualization.framework Linux VM, configures Docker, containerd, or Kubernetes inside it, and exposes a local socket so your terminal, IDE, and CI scripts work exactly like they would against Docker Desktop — without any license cost or tray app.

What Colima Does

• Boots a tuned Alpine/Ubuntu Lima VM in seconds with sensible defaults for Intel and Apple Silicon Macs.
• Installs and wires up the chosen container runtime (Docker engine, containerd, or the Incus daemon).
• Exposes docker, nerdctl, and kubectl sockets on the host transparently.
• Provisions an optional k3s-based Kubernetes cluster with a working LoadBalancer and storage class.
• Supports multiple named profiles so you can keep work, demo, and arm64 VMs side by side.

Architecture Overview

Colima is a Go CLI that orchestrates Lima for VM lifecycle, writes runtime configs (Docker daemon.json, containerd config, k3s flags), and forwards the relevant Unix sockets back to the host through Lima''s SSH tunnels. On Apple Silicon it defaults to the lighter vz Virtualization.framework driver, falling back to QEMU when nested features (like Rosetta for x86_64 binaries) are required. Profiles are plain YAML under ~/.colima/, so configs are reproducible and easy to commit.

Self-Hosting & Configuration

• Install with Homebrew, MacPorts, Nix, or a tarball release; Linux users can go install from source.
• Tune resources: colima start --cpu 6 --memory 12 --disk 100 --arch aarch64.
• Mount extra host directories: --mount $HOME/code:w makes the path read-write inside the VM.
• Switch runtimes on the fly: colima start --runtime containerd for nerdctl and BuildKit natively.
• Persist settings by editing ~/.colima/<profile>/colima.yaml; run colima template to scaffold one.

Key Features

• Zero-config Docker CLI compatibility — docker context use colima and existing scripts just work.
• Built-in Kubernetes (k3s) with Traefik ingress and a local-path storage class.
• Rosetta-accelerated x86_64 emulation on Apple Silicon for multi-arch builds.
• Port forwarding, bind mounts, and SSHFS out of the box, managed by Lima.
• Open-source, MIT licensed, no tray app, no login wall — scriptable from CI and dotfiles.

Comparison with Similar Tools

• Docker Desktop — official GUI with full feature set, but paid for larger orgs and heavy on resources.
• Rancher Desktop — similar open-source desktop option with a UI; Colima is CLI-only and lighter.
• Podman Machine — Podman''s built-in VM; great for rootless workflows, but Docker compatibility requires shims.
• Minikube / kind — Kubernetes-first tools; Colima covers plain Docker use cases and Kubernetes in one VM.
• Lima (raw) — the VM layer Colima is built on; use it directly for non-container Linux VMs.

FAQ

Q: Does Colima need Docker Desktop installed? A: No. It only needs the Docker CLI (brew install docker) or nerdctl; the daemon runs inside the VM.

Q: Can I run GPU workloads? A: Not on macOS — the VM layer doesn''t expose host GPUs. On Linux you can pass through devices via Lima.

Q: How do I reset everything? A: colima stop && colima delete removes the VM and profile state; colima start recreates it fresh.

Q: Will my x86_64 images run on Apple Silicon? A: Yes. Enable Rosetta with colima start --vz-rosetta for near-native x86_64 execution speed.

Sources

• https://github.com/abiosoft/colima
• https://github.com/lima-vm/lima