LinuxCommandLibrary

colima

container runtime for macOS and Linux

TLDR

Start with defaults

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

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
copy

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)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community