https://github.com/containerd/runwasi
Facilitates running Wasm / WASI workloads managed by containerd
https://github.com/containerd/runwasi
containerd kubernetes rust wasi wasm webassembly
Last synced: 9 days ago
JSON representation
Facilitates running Wasm / WASI workloads managed by containerd
- Host: GitHub
- URL: https://github.com/containerd/runwasi
- Owner: containerd
- License: apache-2.0
- Created: 2022-01-27T17:34:28.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-04-10T00:27:00.000Z (9 days ago)
- Last Synced: 2025-04-10T01:25:37.896Z (9 days ago)
- Topics: containerd, kubernetes, rust, wasi, wasm, webassembly
- Language: Rust
- Homepage: https://runwasi.dev/
- Size: 9.26 MB
- Stars: 1,161
- Watchers: 34
- Forks: 100
- Open Issues: 47
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-webassembly - containerd/runwasi
- awesome-repositories - containerd/runwasi - Facilitates running Wasm / WASI workloads managed by containerd (Rust)
README
runwasi
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
- If you haven't joined the CNCF slack yet, you can do so [here](https://slack.cncf.io/).
- Come join us on our [slack channel #runwasi](https://cloud-native.slack.com/archives/C04LTPB6Z0V) on the CNCF slack.
- Public Community Call on Tuesdays every other week at 9:00 AM PT: [Zoom](https://zoom.us/my/containerd?pwd=bENmREpnSGRNRXdBZWV5UG8wbU1oUT09), [Meeting Notes](https://docs.google.com/document/d/1aOJ-O7fgMyRowHD0kOoA2Z_4d19NyAvvdqOkZO3Su_M/edit?usp=sharing)
See our [Community Page](https://runwasi.dev/resources/community.html) for more ways to get involved.
## Documentation
For comprehensive documentation, visit our [Documentation Site](https://runwasi.dev/).
For `containerd-shim-wasm` crate documentation, visit [containerd-shim-wasm](https://docs.rs/containerd-shim-wasm).
## Quick Start
### Installation
```terminal
make build
sudo make install
```
For detailed installation instructions, see the [Installation Guide](https://runwasi.dev/getting-started/installation.html).
### Running an Example
```terminal
# 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](https://runwasi.dev/getting-started/demos.html).
## Projects Using Runwasi
Check out these projects that build on top of runwasi:
- [spinkube/containerd-shim-spin](https://github.com/spinkube/containerd-shim-spin)
- [deislabs/containerd-wasm-shims](https://github.com/deislabs/containerd-wasm-shims)
## Contributing
To begin contributing, please read our [Contributing Guide](https://runwasi.dev/CONTRIBUTING.html).