libracoder

kiri: Run Docker Containers Across macOS, Windows, and Linux

Kiri is a Rust-built container runtime for macOS, Windows, and Linux that runs Docker images and works with the Docker CLI, Compose, and buildx. It uses a small Linux VM on macOS and Windows, and runs directly on the kernel on Linux.

Stars
4.6k
Forks
215
Last commit
today
Contributors
10
Releases, 12 months
6

Our take

Newless than six months old and changing fast

Health score

62/100

How it is scored
Activity
63
Community
34
Issues
75
Pull requests
75
  • Merges more pull requests than 79% of the projects we track

Kiri is a promising, actively changing Rust runtime for Docker-compatible desktop workflows, but its very young age and concentration of development make it a project to evaluate before relying on it broadly.

Good fit if

  • You want Docker CLI and Compose compatibility across macOS, Windows, and Linux, and can test the workflows you depend on.
  • You value its integrated local domains, management window, Kubernetes cluster, or Linux machines.
  • You are comfortable adopting a project under the Apache-2.0 license that is changing quickly and depends mostly on one contributor.

Look elsewhere if

  • Your workflow depends on a built-in image builder today. The project lists this as upcoming work.
  • Your team needs a mature runtime with development spread across a broader contributor base.
  • You need Windows support without WSL 2, or macOS support earlier than macOS 14.
All health signals
Last commit2026-11-15 (today)
Commits, last 90 days95
Releases, last 12 months6 (latest v0.2.1, 2026-11-15)
Contributors10 (top contributor: 84% of commits)
Issues closed, last 90 days14+ (typically closed in 1 day)
Pull requests merged, last 90 days64 (typically merged in 0 days)
Project age12 days

Checked on 2026-11-15 with the GitHub API.

Overview

Kiri is a Rust-built container runtime for macOS, Windows, and Linux. It runs Docker images and speaks the Docker Engine API, so the Docker CLI and Compose can work with it instead of Docker Desktop or OrbStack. On macOS and Windows it runs containers in a Linux VM; on Linux it runs directly on the kernel.

The project aims to make a lightweight runtime useful for everyday container workflows, while adding local domains, a native management window, Kubernetes, and Linux machines. It is a fit for developers who want Docker-compatible container tools across desktop platforms without adopting a separate CLI ecosystem.

Key Features

  • Runs Docker images through the Docker Engine API and supports the Docker CLI, Compose, and buildx.
  • Uses one small Linux VM on macOS and Windows, and runs directly on the Linux kernel.
  • Provides local domains in the form http://<name>.kiri.local, with HTTPS from Kiri's own certificate authority.
  • Includes a native window for managing containers, images, volumes, and networks.
  • Can start a single-node Kubernetes cluster and create Linux machines.
  • Offers image, volume, and container import from OrbStack or Docker Desktop.
  • Supports amd64 images through Rosetta and provides a 38-language interface.

Use Cases

  • Developers who already use Docker CLI or Compose and want a Docker-compatible runtime on macOS, Windows, or Linux.
  • macOS and Windows users seeking an alternative to Docker Desktop or OrbStack for local development containers.
  • Teams that need local HTTPS domains for testing services running in containers.
  • Developers who want to try a local single-node Kubernetes cluster or create Linux machines alongside their containers.

What you need

Detected in the repository

  • Rust (from Cargo.toml)
  • A test suite and automated checks on GitHub Actions

License in plain words

Apache-2.0permissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the license, the NOTICE file and a note of your changes
  • Share your changes: no
  • Includes an explicit patent grant from the contributors:

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install the package for your platform from Kiri's releases page, then try:

docker --context kiri run --rm alpine echo hello

See the README for platform details, setup, and additional commands.

Alternatives

  • podman: Podman manages OCI and Docker containers, but uses a Podman-managed VM on macOS and Windows rather than Kiri’s cross-platform runtime approach.
ProjectLanguageLicenseStarsStatus
kiriRustApache-2.04.6kNew
podmanGoApache-2.033.2kActive

Considerations

Kiri is only 12 days old in the supplied project health data, with recent commits and releases. Although ten contributors are recorded, most of the code comes from one person, so maintenance and project direction are concentrated. The project is changing quickly, and its issue and pull-request activity indicates active development rather than a long-established support record.

Windows runs through WSL 2, and macOS requires version 14 or later. The README also identifies a built-in builder as future work, so teams relying on that integration should verify their build workflow before switching. The project is Apache-2.0 licensed; the guest Linux kernel has a separate GPL-2.0 license, with its source offer and related materials in the repository.

Found this useful?

Share it with someone who would like kiri.