Back to All Projects
Open Source Verified Architecture
kiri
kiri is a lightweight, fast container runtime that works on macOS, Windows and Linux, giving you instant, low‑overhead isolation for your apps. It even includes a built‑in, free Ngrok‑compatible tunnel so you can expose services publicly with a single command.
9,016 Stars 400 Forks
Core Technologies & Frameworks
Rust
Technical Architecture & Specifications
### Overview & Architectural Design
If you run containerized workflows on macOS or Windows, you are likely familiar with the resource tax imposed by traditional desktop tools. Kiri—named after the Igbo word *ntakịrị* ("small")—is a lightweight, open-source container runtime written in Rust designed as a drop-in replacement for Docker Desktop and OrbStack.
Architecturally, Kiri operates by running a minimal background daemon that directly speaks the Docker Engine API. On Linux, it executes natively straight on the kernel. On macOS and Windows, it orchestrates workloads inside a single, tightly constrained Linux virtual machine. Because it exposes standard Docker API endpoints, your existing tooling—including the `docker` CLI, Docker Compose, `buildx`, and `docker login`—works transparently without requiring workflow modifications. For macOS Apple Silicon hosts, Kiri handles `amd64` architecture images using Rosetta emulation.
---
### Key Technical Capabilities
* Engine Speed & Resource Footprint: The core daemon operates with a persistent memory footprint of roughly 15 MB. To minimize system drain, the Linux VM automatically enters a sleep state after 60 seconds of inactivity and cold-wakes in approximately 0.15 seconds when a new request hits the engine. Container lifecycle operations (start to exit) round-trip in about 2.5 ms via the Docker API—roughly 80 times faster than Docker Desktop.
* Networking & Local SSL: Kiri handles local routing out of the box. It provisions local domains following the `http://<name>.kiri.local` convention and includes its own internal Certificate Authority (CA) to handle local HTTPS termination automatically.
* Orchestration & Virtualization: Beyond basic container management, Kiri natively supports one-command Kubernetes cluster provisioning and raw Linux virtual machine management.
* Native GUI & Internationalization: Kiri includes a native management window and menu bar utility for monitoring containers, images, storage volumes, and networks. The interface supports 38 languages out of the box, with full right-to-left (RTL) layout rendering for scripts such as Arabic, Persian, and Central Kurdish.
---
### Setup and Getting Started
Kiri is licensed under Apache-2.0 and supports macOS, Windows, and Linux. You can grab compiled binaries for your platform directly from the project's official releases:
1. Download the Binary:
Obtain the latest binary package for your operating system from [runkiri.com/releases/](https://runkiri.com/releases/) or the project's GitHub Releases page.
2. Run Kiri:
Launch the native desktop application. Once running, Kiri hooks into your system's path, allowing your local environment to target the Kiri daemon seamlessly:
```bash
# Verify the runtime via standard Docker CLI tools
docker ps
# Bring up complex stacks using Docker Compose
docker compose up -d
```
If you prefer building from source or extending the engine, you can clone the repository and build the Rust codebase directly using the instructions provided in `docs/development.md`.
Reviewed by DevTechPulse Editorial Board
All listed blueprints, repositories, and case studies are verified against public documentation and LTS container environments. For inquiries or updates, view our Editorial Policy.