Skip to main content
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.