Illustration of a small lightweight container ship next to a large one

Kiri is an open-source container runtime written in Rust that pitches itself as a lightweight replacement for Docker Desktop and OrbStack on macOS, Windows and Linux. It runs containers inside one small Linux VM (or directly on the kernel on Linux) and speaks the Docker Engine API, so the docker CLI, Compose and buildx keep working as before. Published on GitHub by libracoder under Apache 2.0 on 2 November 2026, it already has more than 1,400 stars.

Key points about Kiri in 20 seconds

  • It uses a minimal VM with a custom kernel and a Rust agent as PID 1, with no runc or dockerd.
  • It works with docker, Compose, buildx and docker login.
  • It adds single-node Kubernetes, Linux machines and local HTTPS domains.

The name comes from the Igbo word ntakịrị, “small”, and that sums up the pitch. According to its author, the VM sleeps after 60 seconds idle, the daemon uses about 15 MB of memory and it wakes in roughly 0.15 seconds. For developers running several Compose projects on a laptop, Docker Desktop’s idle footprint is a familiar complaint, and that is the gap Kiri targets.

How it works

The docker CLI, Compose, buildx or Kiri’s own window talk to the Kiri daemon through the Docker Engine API. The daemon owns the VM and talks over vsock to an agent running as PID 1 inside it. The VM boots a custom kernel of about 10 MB, and the roughly 900 KB agent starts each container with a single clone3 into its own namespaces and cgroup. There is no runc, no shim and no dockerd. On Windows it runs through WSL 2, and on macOS it runs amd64 images through Rosetta.

That design explains its numbers. In the project’s benchmark, starting and removing an alpine container that runs true (median of 30 runs) takes 2.55 ms through the Docker Engine API on Kiri, against 213 ms on Docker Desktop and 380 ms on OrbStack; through the docker CLI, 14.2 ms against 243 and 442 ms. These are the author’s own measurements, reproducible with kiri bench. They measure the start-up cost of a trivial container, not the performance of real workloads with volumes or networking.

Installation and first steps

Packages are available from runkiri.com: .dmg for macOS 14 or later (Apple silicon and Intel), .msi for Windows 10 and 11 (x86-64 and Arm) and .deb or .rpm for Linux. On first launch it creates a Docker context called kiri, so it can live alongside another installation:

docker --context kiri run --rm alpine echo hello
docker --context kiri compose up -d

# Single-node Kubernetes as the "kiri" kubectl context
kiri k8s start

# A Linux dev machine
kiri machine create dev --distro ubuntu && kiri machine shell dev

# Bring images, volumes and containers over from OrbStack or Docker Desktop
kiri importCode language: PHP (php)

Docker’s commands also work as kiri run, kiri ps or kiri compose up. Kiri adds local domains such as http://name.kiri.local, with HTTPS from its own certificate authority, a native window for containers, images, volumes and networks, and a user interface in 15 languages.

What to check before switching

The project is only days old, so it is wise to try it on non-critical work first. Installing its own certificate authority for .kiri.local domains means trusting it, so check how its key is generated and protected. Kiri updates itself and, according to the README, verifies each release’s signature before installing it. The roadmap includes a built-in builder that will serve Docker’s build endpoints so buildx can use its native docker driver. Apache 2.0 covers the code, the guest kernel is Linux (GPL-2.0), and the name and logo may not be reused in forks. For servers, containers still belong to Docker Engine, Podman or Kubernetes; Kiri is aimed at the developer’s desktop.

Frequently asked questions

Does Kiri replace Docker Desktop?

That is its pitch: it speaks the Docker Engine API, so docker, Compose and buildx work with it unchanged.

Which systems does it support?

macOS 14 or later, Windows 10 and 11 through WSL 2, and Linux distributions such as Ubuntu and Fedora.

Can I migrate from OrbStack?

Yes. The kiri import command brings over images, volumes and containers from OrbStack or Docker Desktop.

Sources:

Scroll to Top