[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-5569":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":25,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":32,"readmeContent":33,"aiSummary":34,"trendingCount":16,"starSnapshotCount":16,"syncStatus":17,"lastSyncTime":35,"discoverSource":36},5569,"youki","youki-dev\u002Fyouki","youki-dev","A container runtime written in Rust","https:\u002F\u002Fyouki-dev.github.io\u002Fyouki\u002F",null,"Rust",7443,441,55,86,0,2,12,46,11,38.94,"Apache License 2.0",false,"main",true,[27,28,29,30,31],"containers","docker","kubernetes","oci","rust","2026-06-12 02:01:12","# youki: A container runtime in Rust\n\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fdiscord\u002F849943000770412575.svg?logo=discord)](https:\u002F\u002Fdiscord.gg\u002FzHnyXKSQFD)\n[![GitHub contributors](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcontributors\u002Fyouki-dev\u002Fyouki)](https:\u002F\u002Fgithub.com\u002Fyouki-dev\u002Fyouki\u002Fgraphs\u002Fcontributors)\n[![Github CI](https:\u002F\u002Fgithub.com\u002Fyouki-dev\u002Fyouki\u002Factions\u002Fworkflows\u002Fbasic.yml\u002Fbadge.svg?branch=main)](https:\u002F\u002Fgithub.com\u002Fyouki-dev\u002Fyouki\u002Factions)\n[![FOSSA Status](https:\u002F\u002Fapp.fossa.com\u002Fapi\u002Fprojects\u002Fgit%2Bgithub.com%2Fyouki-dev%2Fyouki.svg?type=shield)](https:\u002F\u002Fapp.fossa.com\u002Fprojects\u002Fgit%2Bgithub.com%2Fyouki-dev%2Fyouki?ref=badge_shield)\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fyouki.png\" width=\"450\">\n\u003C\u002Fp>\n\n**youki** is an implementation of the [OCI runtime-spec](https:\u002F\u002Fgithub.com\u002Fopencontainers\u002Fruntime-spec) in Rust, similar to [runc](https:\u002F\u002Fgithub.com\u002Fopencontainers\u002Frunc).  \nYour ideas are welcome [here](https:\u002F\u002Fgithub.com\u002Fyouki-dev\u002Fyouki\u002Fissues\u002F10).\n\n# 🏷️ About the name\n\nyouki is pronounced as \u002Fjoʊki\u002F or yoh-key.\nyouki is named after the Japanese word 'youki', which means 'a container'. In Japanese language, youki also means 'cheerful', 'merry', or 'hilarious'.\n\n# 🚀 Quick Start\n\n> [!TIP]\n> You can immediately set up your environment with youki on GitHub Codespaces and try it out.  \n>\n> [![Open in GitHub Codespaces](https:\u002F\u002Fgithub.com\u002Fcodespaces\u002Fbadge.svg)](https:\u002F\u002Fcodespaces.new\u002Fyouki-dev\u002Fyouki?quickstart=1)\n> ```console\n> just build\n> docker run --runtime youki hello-world\n> sudo podman run --cgroup-manager=cgroupfs --runtime \u002Fworkspaces\u002Fyouki\u002Fyouki hello-world\n> ```\n\n[User Documentation](https:\u002F\u002Fyouki-dev.github.io\u002Fyouki\u002Fuser\u002Fbasic_setup.html#quick-install)\n\n# 🎯 Motivation\n\nHere is why we are writing a new container runtime in Rust.\n\n- Rust is one of the best languages to implement the oci-runtime spec. Many very nice container tools are currently written in Go. However, the container runtime requires the use of system calls, which requires a bit of special handling when implemented in Go. This is tricky (e.g. _namespaces(7)_, _fork(2)_); with Rust too, but it's not that tricky. And, unlike in C, Rust provides the benefit of memory safety. While Rust is not yet a major player in the container field, it has the potential to contribute a lot: something this project attempts to exemplify.\n- youki has the potential to be faster and use less memory than runc, and therefore work in environments with tight memory usage requirements. Here is a simple benchmark of a container from creation to deletion.\n  |  Runtime | Time (mean ± σ) | \tRange (min … max) | vs youki(mean) | Version | \n  | -------- | -------- | -------- | -------- | -------- |\n  | youki     | 111.5 ms ± 11.6 ms  | 84.0 ms ± 142.5 ms   | 100% | 0.3.3 |\n  | runc     | 224.6 ms ± 12.0 ms  | 190.5 ms ± 255.4 ms   | 200% | 1.1.7 |\n  | crun     | 47.3 ms ± 2.8 ms  | 42.4 ms ± 56.2 ms   | 42% | 1.15 |\n    \u003Cdetails>\n  \u003Csummary>Details about the benchmark\u003C\u002Fsummary>\n\n  - A command used for the benchmark\n\n    ```bash\n    hyperfine --prepare 'sudo sync; echo 3 | sudo tee \u002Fproc\u002Fsys\u002Fvm\u002Fdrop_caches' --warmup 10 --min-runs 100 'sudo .\u002Fyouki create -b tutorial a && sudo .\u002Fyouki start a && sudo .\u002Fyouki delete -f a'\n    ```\n\n  - Environment\n\n    ```console\n    $ .\u002Fyouki info\n    Version           0.3.3\n    Commit            4f3c8307\n    Kernel-Release    6.5.0-35-generic\n    Kernel-Version    #35~22.04.1-Ubuntu SMP PREEMPT_DYNAMIC Tue May  7 09:00:52 UTC 2\n    Architecture      x86_64\n    Operating System  Ubuntu 22.04.4 LTS\n    Cores             16\n    Total Memory      63870\n    Cgroup setup      unified\n    Cgroup mounts\n    Namespaces        enabled\n      mount           enabled\n      uts             enabled\n      ipc             enabled\n      user            enabled\n      pid             enabled\n      network         enabled\n      cgroup          enabled\n    Capabilities\n    CAP_BPF           available\n    CAP_PERFMON       available\n    CAP_CHECKPOINT_RESTORE available\n    ```\n\n  \u003C\u002Fdetails>\n\n- I have fun implementing this. In fact, this may be the most important.\n\n# 📍 Status of youki\n\n**youki** has aced real-world use cases, including containerd's e2e test, and is now adopted by several production environments. See [Adopters and Use Cases](https:\u002F\u002Fyouki-dev.github.io\u002Fyouki\u002Fcommunity\u002Fadopters_and_use_cases.html) for public examples.\nWe have [our roadmap](https:\u002F\u002Fgithub.com\u002Forgs\u002Fcontainers\u002Fprojects\u002F15).\n\n![youki demo](docs\u002Fdemo.gif)\n\n# 🔗 Related project\n\n- [youki-dev\u002Foci-spec-rs](https:\u002F\u002Fgithub.com\u002Fyouki-dev\u002Foci-spec-rs) - OCI Runtime and Image Spec in Rust\n\n# 🎨 Design and implementation of youki\n\nThe User and Developer Documentation for youki is hosted at [https:\u002F\u002Fyouki-dev.github.io\u002Fyouki\u002F](https:\u002F\u002Fyouki-dev.github.io\u002Fyouki\u002F)\n\n![Architecture](docs\u002F.drawio.svg)\n\n# 🎬 Getting Started\n\nLocal build is only supported on Linux.\nFor other platforms, please use the [Vagrantfile](#setting-up-vagrant) that we have prepared. You can also spin up a fully preconfigured development environment in the cloud with [GitHub Codespaces](https:\u002F\u002Fdocs.github.com\u002Fen\u002Fcodespaces\u002Fgetting-started\u002Fquickstart).\n\n## Requires\n\n- Rust(See [here](https:\u002F\u002Fwww.rust-lang.org\u002Ftools\u002Finstall)), edition 2024\n- linux kernel ≥ 5.3\n\n## Dependencies\n\nTo install `just`, follow the instruction [here](https:\u002F\u002Fgithub.com\u002Fcasey\u002Fjust#installation).\n\n### Debian, Ubuntu and related distributions\n\n```console\nsudo apt-get install    \\\n      pkg-config        \\\n      libsystemd-dev    \\\n      build-essential   \\\n      libelf-dev        \\\n      libseccomp-dev    \\\n      libclang-dev      \\\n      libssl-dev\n```\n\n### Fedora, CentOS, RHEL and related distributions\n\n```console\nsudo dnf install            \\\n      pkg-config            \\\n      systemd-devel         \\\n      elfutils-libelf-devel \\\n      libseccomp-devel      \\\n      clang-devel           \\\n      openssl-devel\n```\n\n## Build\n\n```bash\ngit clone git@github.com:youki-dev\u002Fyouki.git\ncd youki\njust youki-dev # or youki-release\n.\u002Fyouki -h # you can get information about youki command\n```\n\n## Tutorial\n\n### Requires\n\n- Docker(See [here](https:\u002F\u002Fdocs.docker.com\u002Fengine\u002Finstall))\n\n### Create and run a container\n\nLet's try to run a container that executes `sleep 30` with youki. This tutorial may need root permission.\n\n```bash\ngit clone git@github.com:youki-dev\u002Fyouki.git\ncd youki\njust youki-dev # or youki-release\n\nmkdir -p tutorial\u002Frootfs\ncd tutorial\n# use docker to export busybox into the rootfs directory\ndocker export $(docker create busybox) | tar -C rootfs -xvf -\n```\n\nThen, we need to prepare a configuration file. This file contains metadata and specs for a container, such as the process to run, environment variables to inject, sandboxing features to use, etc.\n\n```bash\n..\u002Fyouki spec  # will generate a spec file named config.json\n```\n\nWe can edit the `config.json` to add customized behaviors for container. Here, we modify the `process` field to run `sleep 30`.\n\n```json\n  \"process\": {\n    ...\n    \"args\": [\n      \"sleep\", \"30\"\n    ],\n\n  ...\n  }\n```\n\nThen we can explore the lifecycle of a container:\n\n```bash\ncd ..                                                # go back to the repository root\nsudo .\u002Fyouki create -b tutorial tutorial_container   # create a container with name `tutorial_container`\nsudo .\u002Fyouki state tutorial_container                # you can see the state the container is `created`\nsudo .\u002Fyouki start tutorial_container                # start the container\nsudo .\u002Fyouki list                                    # will show the list of containers, the container is `running`\nsudo .\u002Fyouki delete tutorial_container               # delete the container\n```\n\nChange the command to be executed in `config.json` and try something other than `sleep 30`.\n\n### Rootless container\n\n`youki` provides the ability to run containers as non-root user([rootless mode](https:\u002F\u002Fdocs.docker.com\u002Fengine\u002Fsecurity\u002Frootless\u002F)). To run a container in rootless mode, we need to add some extra options in `config.json`, other steps are same with above:\n\n```bash\nmkdir -p tutorial\u002Frootfs\ncd tutorial\n# use docker to export busybox into the rootfs directory\ndocker export $(docker create busybox) | tar -C rootfs -xvf -\n\n..\u002Fyouki spec --rootless          # will generate a spec file named config.json with rootless mode\n## Modify the `args` field as you like\n\n..\u002Fyouki run rootless-container   # will create and run a container with rootless mode\n```\n\n## Usage\n\nStart the docker daemon.\n\n```bash\ndockerd --experimental --add-runtime=\"youki=$(pwd)\u002Fyouki\"\n```\n\nIf you get an error like the below, that means your normal Docker daemon is running, and it needs to be stopped. Do that with your init system (i.e., with systemd, run `sudo systemctl stop docker`, as root if necessary).\n\n```console\nfailed to start daemon: pid file found, ensure docker is not running or delete \u002Fvar\u002Frun\u002Fdocker.pid\n```\n\nNow repeat the command, which should start the docker daemon.\n\nYou can use youki in a different terminal to start the container.\n\n```bash\ndocker run -it --rm --runtime youki busybox\n```\n\nAfterwards, you can close the docker daemon process in other the other terminal. To restart normal docker daemon (if you had stopped it before), run:\n\n```bash\nsudo systemctl start docker\n```\n\n### Integration Tests\n\nGo and node-tap are required to run integration tests. See the [opencontainers\u002Fruntime-tools](https:\u002F\u002Fgithub.com\u002Fopencontainers\u002Fruntime-tools) README for details.\n\n```bash\ngit submodule update --init --recursive\njust test-oci\n```\n\n### Setting up Vagrant\n\nYou can try youki on platforms other than Linux by using the Vagrantfile we have prepared. We have prepared two environments for vagrant, namely rootless mode and rootful mode\n\n```bash\ngit clone git@github.com:youki-dev\u002Fyouki.git\ncd youki\n\n# If you want to develop in rootless mode, and this is the default mode\nvagrant up default\nvagrant ssh default\n\n# or if you want to develop in rootful mode\nvagrant up rootful\nvagrant ssh rootful\n\n# in virtual machine\ncd youki\njust youki-dev # or youki-release\n```\n\n# 👥 Community and Contributing\n\nPlease refer to [our community page](https:\u002F\u002Fyouki-dev.github.io\u002Fyouki\u002Fcommunity\u002Fintroduction.html).\n\nThanks to all the people who already contributed!\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fyouki-dev\u002Fyouki\u002Fgraphs\u002Fcontributors\">\n  \u003Cimg src=\"https:\u002F\u002Fcontributors-img.web.app\u002Fimage?repo=youki-dev\u002Fyouki\" \u002F>\n\u003C\u002Fa>\n\n- - -\n**We are a [Cloud Native Computing Foundation](https:\u002F\u002Fcncf.io\u002F) sandbox project.**\n\n\u003Cpicture>\n  \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fwww.cncf.io\u002Fwp-content\u002Fuploads\u002F2022\u002F07\u002Fcncf-white-logo.svg\">\n  \u003Cimg src=\"https:\u002F\u002Fwww.cncf.io\u002Fwp-content\u002Fuploads\u002F2022\u002F07\u002Fcncf-color-bg.svg\" width=300 \u002F>\n\u003C\u002Fpicture>\n\nThe Linux Foundation® (TLF) has registered trademarks and uses trademarks. For a list of TLF trademarks, see [Trademark Usage](https:\u002F\u002Fwww.linuxfoundation.org\u002Flegal\u002Ftrademark-usage).\n\nCopyright Contributors to youki, established as youki a Series of LF Projects, LLC.\n\n\n## License\n[![FOSSA Status](https:\u002F\u002Fapp.fossa.com\u002Fapi\u002Fprojects\u002Fgit%2Bgithub.com%2Fyouki-dev%2Fyouki.svg?type=large)](https:\u002F\u002Fapp.fossa.com\u002Fprojects\u002Fgit%2Bgithub.com%2Fyouki-dev%2Fyouki?ref=badge_large)\n","youki 是一个用 Rust 语言实现的容器运行时，遵循 OCI 运行时规范。该项目的核心功能包括通过 Rust 的内存安全特性来优化系统调用处理，从而在保证安全性的同时提高性能和减少内存占用。与 runc 相比，youki 在创建和销毁容器的速度上表现更优，特别适用于对资源使用有严格限制的环境，如边缘计算或物联网设备中。此外，youki 支持 Docker 和 Kubernetes 等主流容器编排工具，使其成为构建高效、安全容器化应用的理想选择。","2026-06-11 03:03:59","top_language"]