colima

container runtime for macOS and Linux

TLDR

Start with defaults
$ colima start
Start with custom resources
$ colima start --cpu [4] --memory [8] --disk [100]
Start with containerd runtime
$ colima start --runtime containerd
Start with Kubernetes
$ colima start --kubernetes
Stop Colima
$ colima stop
Delete instance
$ colima delete
List instances
$ colima list
SSH into VM
$ colima ssh

SYNOPSIS

colima command [options]

DESCRIPTION

colima provides container runtimes on macOS and Linux with minimal setup and resource requirements. It uses Lima (Linux virtual machines) to create an environment for running Docker and containerd, offering a completely free and open-source alternative to Docker Desktop.On macOS, Colima leverages either QEMU or the native Apple Virtualization framework (VZ) for better performance on Apple Silicon. On Linux, it provides a consistent containerization environment. The tool automatically configures Docker client connectivity, port forwarding, and volume mounts, making the VM layer transparent to users.Colima supports multiple runtime profiles, allowing separate instances with different configurations for various projects. Kubernetes clusters can be enabled for local development. The tool integrates seamlessly with existing Docker workflows, requiring no changes to docker commands or compose files. Resource allocation (CPU, memory, disk) is configurable and lightweight compared to alternatives.

COMMANDS

start

Start Colima VM
stop
Stop Colima VM
delete
Delete Colima instance
status
Show status
list
List instances
ssh
SSH into VM
nerdctl
Run nerdctl (containerd)
version
Show version

START OPTIONS

--cpu n

Number of CPUs
--memory n
Memory in GB
--disk n
Disk size in GB
--runtime type
Runtime: docker, containerd
--kubernetes
Enable Kubernetes
--arch arch
Architecture: x86_64, aarch64
--vm-type type
Virtualization: vz, qemu
--profile name
Instance profile name

DOCKER USAGE

After starting:

$ docker ps
docker run hello-world

INSTALL

brew install colima
nix profile install nixpkgs#colima

CAVEATS

Requires macOS 10.15+ or Linux. vz (Apple virtualization) faster on Apple Silicon. Completely free and open source.

SEE ALSO

docker(1), nerdctl(1), lima(1)

RESOURCES

Source code