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

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/libracoder-kiri
Generated for open source discovery and AI-assisted research.

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.

GitHub: https://github.com/libracoder/kiri
OSRepos URL: https://osrepos.com/repo/libracoder-kiri

## Summary

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.

## Topics

- rust
- docker
- containers
- cross-platform
- container-runtime
- docker-desktop-alternative
- local-kubernetes

## Repository Information

Last analyzed by OSRepos: Sun Nov 15 2026 11:23:24 GMT+0000 (Western European Standard Time)
Detail views: 17
GitHub clicks: 7

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## 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.

## Our Take

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.

## Project Health

| Signal | Value |
|---|---|
| Status | **New**: less than six months old and changing fast |
| Last commit | 2026-11-15 (today) |
| Commits, last 90 days | 95 |
| Releases, last 12 months | 6 (latest v0.2.1, 2026-11-15) |
| Contributors | 10 (top contributor: 84% of commits) |
| Issues closed, last 90 days | 14+ (typically closed in 1 day) |
| Pull requests merged, last 90 days | 64 (typically merged in 0 days) |
| Project age | 12 days |

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

## Project Facts

- Language: Rust
- License: Apache-2.0
- Stars: 4.6k
- Forks: 215
- Topics: containers, docker, kubernetes, linux, macos, oci, windows
- Website: https://runkiri.com
- Archived: no

## What You Need

Detected in the repository:

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

## Getting Started

Install the package for your platform from [Kiri's releases page](https://runkiri.com/releases/), then try:

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

See the [README](https://github.com/libracoder/kiri#readme) for platform details, setup, and additional commands.

## License in Plain Words

**Apache-2.0** (permissive).

- 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.

## Alternatives

- [podman](https://osrepos.com/repo/containers-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.

| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| **kiri** | Rust | Apache-2.0 | 4.6k | New |
| [podman](https://osrepos.com/repo/containers-podman) | Go | Apache-2.0 | 33.2k | Active |

## 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.