Colima — Container Runtimes on macOS & Linux in a Lima VM
Colima provides minimal-setup container and Kubernetes runtimes on macOS and Linux using a Lima VM, offering a true Docker Desktop alternative without the license fees.
What it is
Colima provides minimal-setup container and Kubernetes runtimes on macOS and Linux using a Lima VM. It offers a genuine Docker Desktop alternative without the licensing fees that Docker Desktop requires for commercial use. Colima manages a lightweight Linux VM, connects the Docker CLI to it, and optionally bundles a single-node Kubernetes cluster.
Colima targets developers and teams on macOS who need Docker containers for local development but want to avoid Docker Desktop's subscription model. It also works on Linux for users who prefer VM-based container isolation.
How it saves time or tokens
Colima installs with a single Homebrew command and starts in seconds. It uses the same Docker CLI and Docker Compose commands you already know, so there is no workflow change. For teams, switching from Docker Desktop eliminates per-seat licensing costs. The lightweight Lima VM uses fewer resources than Docker Desktop's built-in VM, leaving more memory for your containers.
How to use
- Install Colima and the Docker CLI:
brew install colima docker
- Start the VM with default settings (2 CPU, 2 GiB RAM, 60 GiB disk):
colima start
- Run containers normally:
docker run --rm hello-world
docker compose up -d
- Optionally start with Kubernetes:
colima start --kubernetes
kubectl get nodes
Example
# Custom VM configuration for heavy workloads
colima start --cpu 4 --memory 8 --disk 100
# Check status
colima status
# SSH into the VM
colima ssh
# Stop and free resources
colima stop
# Delete the VM entirely
colima delete
Related on TokRepo
- DevOps Tools — Container and infrastructure tools for development teams
- Self-Hosted Tools — Run your own infrastructure without SaaS dependencies
This tool integrates with standard development workflows and requires minimal configuration to get started. It is available as open-source software with documentation and community support through the official repository. The project follows semantic versioning for stable releases.
For teams evaluating this tool, the key advantage is reducing manual work in repetitive tasks. The automation provided by the built-in features means less custom code to maintain and fewer integration points to manage. This translates directly to lower maintenance costs and faster iteration cycles.
Common pitfalls
- File system mounts between macOS and the Lima VM can be slow for large projects; use Colima's
--mount-type virtiofsflag for better I/O performance on Apple Silicon Macs. - The default 2 GiB memory allocation is insufficient for running multiple containers or Kubernetes; increase it with
--memory 8or higher at start time. - Colima and Docker Desktop cannot run simultaneously; stop Docker Desktop before starting Colima to avoid socket conflicts.
Frequently Asked Questions
For command-line workflows, yes. Colima provides the Docker engine, Docker CLI, and Docker Compose support. It does not include Docker Desktop's GUI dashboard, but all container operations work identically from the terminal.
Yes. Colima supports both Intel and Apple Silicon (M1/M2/M3/M4) Macs. On Apple Silicon, it uses the Virtualization.framework for better performance and lower overhead compared to QEMU-based solutions.
Yes. Install docker-compose (v2) via Homebrew and it works seamlessly with the Colima Docker socket. All standard docker compose commands function as expected.
Yes. Start Colima with the --kubernetes flag to get a single-node K3s cluster. kubectl and Helm work normally against this cluster for local development and testing.
Colima runs a Docker-compatible engine in a VM, so existing Docker commands and Dockerfiles work without modification. Podman is a daemonless alternative with a different architecture. If your toolchain depends on Docker CLI compatibility, Colima has fewer friction points.
Citations (3)
- Colima GitHub— Colima uses Lima VM to provide container runtimes on macOS
- Lima GitHub— Lima provides Linux virtual machines on macOS with automatic file sharing
- Docker Pricing— Docker Desktop requires a paid subscription for commercial use in organizations …
Related on TokRepo
Discussion
Related Assets
NAPI-RS — Build Node.js Native Addons in Rust
Write high-performance Node.js native modules in Rust with automatic TypeScript type generation and cross-platform prebuilt binaries.
Mamba — Fast Cross-Platform Package Manager
A drop-in conda replacement written in C++ that resolves environments in seconds instead of minutes.
Plasmo — The Browser Extension Framework
Build, test, and publish browser extensions for Chrome, Firefox, and Edge using React or Vue with hot-reload and automatic manifest generation.