Facilitates running Wasm / WASI workloads managed by containerd
Go to file
Jiaxiao Zhou dd3404f0ba
Merge pull request #1015 from containerd/dependabot/cargo/patch-dd3b444903
chore(deps): bump libc from 0.2.173 to 0.2.174 in the patch group
2025-06-23 21:52:28 -07:00
.cargo use cross-rs (#332) 2023-10-03 14:22:47 -04:00
.github chore(deps): bump sigstore/cosign-installer from 3.8.2 to 3.9.1 2025-06-23 18:00:55 +00:00
art/logo Docs: Add light and dark mode logo (#90) 2023-03-20 22:02:36 -07:00
benches/containerd-shim-benchmarks chore: bump rust version to 1.85.0 and edition to 2024 2025-02-20 22:46:00 +00:00
crates chore(deps): bump the patch group with 3 updates 2025-06-16 18:07:17 +00:00
cross fix name to openssl 2024-10-01 17:14:18 +00:00
docs docs: update quickstart to use containerd v2 configuration 2025-06-05 14:37:01 +09:00
scripts delete setup-containerd.sh (#966) 2025-04-11 15:16:34 +01:00
test feat: Add systemd cgroup support for k3s and k8s 2025-03-08 08:47:38 +09:00
.dockerignore Change releases to reflect per-package tags 2023-03-06 18:42:39 +00:00
.gitignore reuse artifacts 2023-08-24 15:45:37 +01:00
.gitmodules remove wasm microbenchmarks 2024-12-31 11:33:39 +00:00
CONTRIBUTING.md docs: fixed all the broken links 2025-03-20 22:17:02 +00:00
Cargo.lock chore(deps): bump libc from 0.2.173 to 0.2.174 in the patch group 2025-06-23 18:07:21 +00:00
Cargo.toml chore(deps): bump libc from 0.2.173 to 0.2.174 in the patch group 2025-06-23 18:07:21 +00:00
Cross.toml use cross-rs (#332) 2023-10-03 14:22:47 -04:00
LICENSE add standard containerd org documentation and licensing 2022-12-01 17:39:50 -05:00
MAINTAINERS promote andreiltd to reviewer 2024-11-18 18:01:28 +00:00
Makefile add build, check and test targets for shimkit 2025-03-26 16:56:05 +00:00
NOTICE refactor(wasmtime): use upstream wasmparser 2024-01-09 18:50:35 +00:00
README.md docs: fixed all the broken links 2025-03-20 22:17:02 +00:00
RELEASE.md RELEASE: fix the wrong variable name 2025-03-26 17:43:48 +00:00
SECURITY.md add standard containerd org documentation and licensing 2022-12-01 17:39:50 -05:00
rust-toolchain.toml chore: bump rust version to 1.85.0 and edition to 2024 2025-02-20 22:46:00 +00:00
rustfmt.toml Windows builds 2023-08-22 14:15:08 -07:00
typos.toml make typos happy 2025-03-03 07:57:59 +00:00

README.md

runwasi logo

runwasi

CI status crates.io docs.rs Downloads website

This is a project to facilitate running wasm workloads managed by containerd either directly (ie. through ctr) or as directed by Kubelet via the CRI plugin. It is intended to be a (rust) library that you can take and integrate with your wasm host. Included in the repository is a PoC for running a plain wasi host (ie. no extra host functions except to support wasi system calls).

Community

See our Community Page for more ways to get involved.

Documentation

For comprehensive documentation, visit our Documentation Site.

For containerd-shim-wasm crate documentation, visit containerd-shim-wasm.

Quick Start

Installation

make build
sudo make install

For detailed installation instructions, see the Installation Guide.

Running an Example

# Pull the image
sudo ctr images pull ghcr.io/containerd/runwasi/wasi-demo-app:latest

# Run the example
sudo ctr run --rm --runtime=io.containerd.wasmtime.v1 ghcr.io/containerd/runwasi/wasi-demo-app:latest testwasm

For more examples and detailed usage, see the Demos.

Projects Using Runwasi

Check out these projects that build on top of runwasi:

Contributing

To begin contributing, please read our Contributing Guide.