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 CLI, Compose и buildx, которыми вы уже пользуетесь.
Это замена Docker Desktop?Да, в README она описана как более легкая замена Docker Desktop и OrbStack. Контейнеры запускаются в одной небольшой виртуальной машине Linux (или напрямую в ядре на Linux) и используют API Docker Engine.
Как это запустить?Скачайте .dmg на macOS, .msi на Windows или .deb/.rpm на Linux с runkiri.com/releases. При первом запуске она настраивает Docker-контекст kiri. Команды Docker также работают как команды kiri, например kiri run или kiri compose up.
Нужно ли что-то установить заранее, например WSL в Windows?В Windows нужен WSL 2. На Mac нужна macOS 14 или новее. В README не упоминается отдельная установка Docker, так как docker CLI, Compose и buildx, которыми вы уже пользуетесь, продолжают работать.
Уже поддерживается всё, что есть в Docker Desktop?Не полностью. Встроенный сборщик пока в планах, поэтому сборки через buildx пока не обслуживаются собственными конечными точками сборки Kiri. В документе Features перечислено, что поддерживается сейчас, и известные проблемы.
Работает ли она на Apple silicon и на Intel Mac?Работает на обоих: macOS 14+ на Apple silicon или Intel и Windows 10/11 на x86-64 или Arm. В README сказано, что образы amd64 на Apple silicon запускаются через Rosetta.
Есть ли подводные камни в лицензии?Код распространяется под лицензией Apache-2.0, но название 'Kiri' и его логотип лицензией не покрываются, а гостевое ядро под GPL-2.0. Форки приветствуются под другим названием и с другим логотипом.
Почему она так быстрая?Виртуальная машина использует собственное ядро размером 10 МБ, а её PID 1 — агент на Rust размером около 900 КБ. Этот агент запускает контейнеры одним вызовом clone3 в namespaces и cgroup, без runc, shim или dockerd.
Что ещё она умеет, помимо контейнеров?Она может запустить кластер Kubernetes одной командой и виртуальные машины Linux. Также есть собственное окно для контейнеров, образов, томов и сетей, а также значок в строке меню.
Откуда взялось название Kiri?Оно происходит от слова 'ntakịrị' из языка игбо, что значит 'маленький'.
Как она сравнивается по скорости?В тесте из README с запуском alpine (медиана 30 запусков, Engine API) Kiri заняла 2,55 мс, против 213 мс у Docker Desktop и 380 мс у OrbStack.
Какие есть похожие проекты?smolvm, arcbox, podman, containerd, gvisor, colima, coop, container
Автор
libracoder
Размер
2.4 MB
Звёзды
10.1K
Возраст
16 д
Коммиты · 90 дней