Skip to main content

How to use openRuyi in Container

Prerequisites​

For non-RISC-V architectures, you must run the registration tool via Docker or Podman.

docker run --privileged --rm tonistiigi/binfmt --install all

Running with Docker or Podman​

It's really simple! Just pull our latest docker image, Podman users can simply replace docker with podman.

docker pull ghcr.io/openruyi-project/creek:latest

Then run it. And voila, welcome to openRuyi!

docker run -it ghcr.io/openruyi-project/creek:latest

We recommend adding the --rm flag to automatically remove the container upon exit, saving disk space.

Container Image

Running with systemd-nspawn​

Create the target directory.

mkdir -p openruyi-nspawn

Extract the rootfs archive.

tar -xf openRuyi-2026.03-rootfs.tar.zst -C openruyi-nspawn --numeric-owner

Start with systemd-nspawn.

systemd-nspawn -D openruyi-nspawn

nspawn Image

Need the Rootfs Instead?​

If you need to download the rootfs separately for any reason, please visit our news site and refer to the latest release article for download links.