Colima is a container runtime management tool designed to simplify running containers on macOS and Linux with minimal configuration overhead. Written in Go, it provides a unified command-line interface for managing multiple container runtimes and orchestration platforms on Apple Silicon and Intel-based Macs, as well as Linux systems.
The project supports three primary container runtimes: Docker, Containerd, and Incus. For Docker, users can leverage the standard Docker client after starting Colima without additional setup. Containerd integration includes support for nerdctl, a Docker-compatible CLI for containerd. Incus support enables both container and virtual machine workloads, with VM functionality limited to m3 or newer Apple Silicon devices. Each runtime can be selected at startup, and Colima defaults to Docker if no preference is specified.
Kubernetes integration is available across Docker and Containerd runtimes through an optional flag at startup. The tool handles image registry interactions differently depending on the runtime: Docker images are directly accessible to Kubernetes, while Containerd requires images to be built or pulled in the k8s.io namespace for Kubernetes access. This design allows developers to use Kubernetes locally without complex configuration.
GPU-accelerated container support for AI workloads represents a significant feature addition, available on Apple Silicon Macs running macOS 13 or later. This functionality uses the krunkit VM type and supports two model runner backends: Docker Model Runner and Ramalama. The Docker Model Runner provides access to Docker AI Registry and HuggingFace, while Ramalama supports HuggingFace and Ollama registries.
The default virtual machine configuration provides 2 CPUs, 2GB of memory, and 100GB of storage, but users can customize these resources through command-line flags or configuration files. Disk size can be increased after VM creation, and the tool supports Rosetta 2 emulation on Apple Silicon for running x86 containers.
Installation is available through multiple package managers including Homebrew, MacPorts, Nix, and Mise, making adoption straightforward for developers already using these tools. The project maintains comprehensive documentation at colima.run and actively engages with the community through GitHub Discussions, the CNCF Slack channel, and announcements on its website.
