kiri README

项目的 README,来自 github.com/libracoder/kiri。合并为一个 markdown 文件:README.md。

Kiri

A tiny, fast container runtime for macOS, Windows and Linux.
Runs your Docker images and works with the docker CLI, Compose and buildx you already use.

Download · Features · Build from source · Releases

Latest release License: Apache-2.0 38 languages

🇬🇧 🇮🇩 🇩🇪 🇪🇸 🇫🇷 🇮🇹 🇵🇱 🇧🇷 🇻🇳 🇹🇷 🇷🇺 🇸🇦 🇯🇵 🇰🇷 🇨🇳 🇹🇼
Kiri speaks 38 languages. Is yours one?

The Kiri window, showing containers grouped by Compose project with their state, ports, local domains and size


Kiri is a lightweight replacement for Docker Desktop and OrbStack, written in Rust. It runs containers in one small Linux VM (or straight on the kernel on Linux) and speaks the Docker Engine API, so your tools just work.

The name comes from the Igbo word ntakịrị, "small".

Why Kiri

In your language

Kiri's window and setup come in these languages. It follows your system's language, and you can change it in Settings → Appearance. In Arabic, Persian and Central Kurdish the whole window reads right to left.

Language Language Language Language
🇬🇧 English 🇳🇴 Norsk bokmål 🇧🇬 Български 🇮🇳 తెలుగు
🇮🇩 Bahasa Indonesia 🇵🇱 Polski 🇷🇺 Русский 🇹🇭 ไทย
🇦🇩 Català 🇧🇷 Português (Brasil) 🇺🇦 Українська 🇱🇦 ລາວ
🇨🇿 Čeština 🇷🇴 Română 🇰🇿 Қазақша 🇯🇵 日本語
🇩🇪 Deutsch 🇦🇱 Shqip 🇸🇦 العربية 🇰🇷 한국어
🇪🇸 Español 🇸🇮 Slovenščina 🇮🇷 فارسی 🇨🇳 简体中文
🇫🇷 Français 🇫🇮 Suomi 🇮🇶 کوردیی ناوەندی 🇹🇼 繁體中文
🇮🇹 Italiano 🇻🇳 Tiếng Việt 🇮🇳 हिन्दी 🇪🇹 አማርኛ
🇱🇹 Lietuvių 🇹🇷 Türkçe 🇧🇩 বাংলা
🇭🇺 Magyar 🇬🇷 Ελληνικά 🇮🇳 தமிழ்

Missing yours? Translations live in crates/kiri/src/ui/lang; see Contributing.

Install

Platform Get it
macOS 14+ (Apple silicon or Intel) .dmg from runkiri.com/releases
Windows 10 and 11 (x86-64 or Arm, through WSL 2) .msi from runkiri.com/releases
Linux (Ubuntu, Fedora and others) .deb or .rpm from runkiri.com/releases

The first time you open Kiri, it sets up a kiri Docker context. Kiri updates itself, and checks each new release's signature first.

Quick start

docker --context kiri run --rm alpine echo hello
docker --context kiri compose up -d
kiri k8s start                      # single-node Kubernetes as the `kiri` kubectl context
kiri machine create dev --distro ubuntu && kiri machine shell dev
kiri import                         # bring images, volumes and containers over from OrbStack or Docker Desktop

Docker's commands also work as kiri commands (kiri run, kiri ps, kiri compose up, and so on), and always target Kiri.

Numbers

alpine running true and removed, median of 30 runs, same docker CLI for all three:

Docker Engine API docker CLI
Kiri 2.55 ms 14.2 ms
Docker Desktop 213 ms 243 ms
OrbStack 380 ms 442 ms

Method and every other figure are in bench/results.json. Rerun with kiri bench.

How it works

docker CLI ─┐
compose ────┼─ Docker Engine API ─► kiri daemon ── vsock ──► guest agent (PID 1)
buildx ─────┤                         owns the VM           clone3 → container
kiri UI ────┘

The VM uses a custom 10 MB kernel, and its PID 1 is a ~900 KB Rust agent. That agent starts containers with a single clone3 into namespaces and a cgroup. There's no runc, no shim and no dockerd. More detail is in docs/development.md.

Documentation

Roadmap

Next is a built-in builder. Kiri will serve Docker's own build endpoints, so buildx uses its docker driver against Kiri as it does against Docker Desktop. This brings host-gateway support to BuildKit builds, and images load straight into Kiri.

Contributing

Issues and pull requests are welcome. See CONTRIBUTING.md and the Code of Conduct. To report a vulnerability privately, see SECURITY.md.

License

Apache-2.0. Third-party licences are in NOTICE. The guest kernel is Linux (GPL-2.0); its config, patches and the source offer are in guest/kernel.

The name "Kiri" and the Kiri logo are not covered by the licence. Forks are welcome, under a different name and logo.

kiri (libracoder/kiri)

正在搜索数据库…

10.1K ·GitHub
这是什么?Kiri 是一个小巧、快速的容器运行时,适用于 macOS、Windows 和 Linux。它可以运行 Docker 镜像,并兼容你已在使用的 docker 命令行工具、Compose 和 buildx。
它是 Docker Desktop 的替代品吗?是的,README 将它介绍为 Docker Desktop 和 OrbStack 的更轻量替代品。它在一个小型 Linux 虚拟机中运行容器(在 Linux 上则直接运行于内核之上),并支持 Docker Engine API。
我该如何让它运行起来?在 macOS 上下载 .dmg,在 Windows 上下载 .msi,在 Linux 上下载 .deb/.rpm,均可从 runkiri.com/releases 获取。首次启动时,它会设置一个 kiri Docker 上下文。Docker 的命令也可以作为 kiri 命令使用,例如 kiri run 或 kiri compose up。
运行前是否需要先安装其他东西,比如 Windows 上的 WSL?在 Windows 上需要 WSL 2。在 Mac 上需要 macOS 14 或更新版本。README 没有提到需要单独安装 Docker,因为你已在使用的 docker 命令行工具、Compose 和 buildx 仍可继续使用。
Docker Desktop 的所有功能都已支持了吗?还没有完全支持。内置构建器仍在路线图中,因此 buildx 构建暂时还不能由 Kiri 自带的构建端点提供服务。Features 文档列出了目前支持的功能和已知问题。
它需要 Apple 芯片,还是也能在 Intel 芯片的 Mac 上运行?两者都支持:macOS 14+ 同时适用于 Apple 芯片和 Intel 芯片,Windows 10/11 适用于 x86-64 或 Arm 架构。README 称,在 Apple 芯片上,amd64 镜像可通过 Rosetta 运行。
许可证方面有什么需要注意的地方吗?代码采用 Apache-2.0 许可,但“Kiri”名称及其标志不在该许可证的覆盖范围内,客户机内核则采用 GPL-2.0 许可。欢迎以其他名称和标志进行分支(fork)。
它为什么这么快?该虚拟机使用一个定制的 10 MB 内核,其 PID 1 进程是一个约 900 KB 的 Rust 代理程序。该代理通过一次 clone3 调用,将容器启动到各自的命名空间和 cgroup 中,无需 runc、shim 或 dockerd。
除了容器,它还能做什么?它可以通过一条命令运行 Kubernetes 集群,也可以运行 Linux 虚拟机。它还提供一个原生窗口,用于管理容器、镜像、卷和网络,并带有菜单栏图标。
“Kiri”这个名字从何而来?它源自伊博语单词“ntakịrị”,意为“小”。
速度方面如何对比?在 README 的测试中,运行 alpine(30 次运行的中位数,Engine API)时,Kiri 耗时 2.55 毫秒,Docker Desktop 为 213 毫秒,OrbStack 为 380 毫秒。
有哪些类似的项目?smolvm, arcbox, podman, containerd, gvisor, colima, coop, container
大小
2.4 MB
星标
10.1K
时长
16天
提交 · 90 天