Installation & System Requirements

Video demo of installing and using the Valida zk-VM stack via Docker.

We provide a Docker container with the Valida LLVM and Rust toolchains already installed. Docker is the only supported method of running on platforms other than x86 Linux.

Installation and usage: x86_64 platforms

# Download the container
docker pull ghcr.io/lita-xyz/llvm-valida-releases/valida-build-container:v1.0.0-amd64

cd your-valida-project

# Enter the container:
docker run --platform linux/amd64 --entrypoint=/bin/bash -it --rm -v $(realpath .):/src ghcr.io/lita-xyz/llvm-valida-releases/valida-build-container:v1.0.0-amd64

# You are now in a shell with the valida rust toolchain installed!

Installation and usage: ARM64 platforms

# Download the container
docker pull ghcr.io/lita-xyz/llvm-valida-releases/valida-build-container:v1.0.0-arm64

cd your-valida-project

# Enter the container:
docker run --platform linux/arm64 --entrypoint=/bin/bash -it --rm -v $(realpath .):/src ghcr.io/lita-xyz/llvm-valida-releases/valida-build-container:v1.0.0-arm64

# You are now in a shell with the valida rust toolchain installed!

System Requirements (non-Docker)

• This toolchain supports x86-64 Linux based on glibc-2.9 or newer glibc.

• rustup is required.

• Arch Linux and Ubuntu 24.04 LTS are specifically supported, with other platforms possibly requiring some tinkering to make work.

---

Installation Instructions (non-Docker)

Download the release bundle, untar it, and run the installation script as root:

wget https://github.com/lita-xyz/llvm-valida-releases/releases/download/v1.0.0/llvm-valida-v1.0.0-linux-x86_64.tar.xz
tar xf llvm-valida-v1.0.0-linux-x86_64.tar.gz
cd valida-toolchain
sudo mkdir -p /valida-toolchain
sudo chown -R $(whoami):$(whoami) /valida-toolchain
./install.sh