Skip to content

Installation

Use this page to install the CLI and the standard tooling used throughout the rest of the docs.

1. Install the wasichain CLI

The CLI is distributed as a prebuilt binary on the GitHub Releases page.

Homebrew on macOS:

brew install wasichain/tap/wasichain

Manual install from a release archive:

curl -L -o wasichain.tar.gz \
  "https://github.com/wasichain/chain/releases/download/v<VERSION>/wasichain-v<VERSION>-x86_64-unknown-linux-gnu.tar.gz"
tar -xzf wasichain.tar.gz
sudo mv wasichain-v<VERSION>-x86_64-unknown-linux-gnu/wasichain /usr/local/bin/wasichain

Use the archive that matches your platform:

  • macOS (Intel): wasichain-v<VERSION>-x86_64-apple-darwin.tar.gz
  • macOS (Apple Silicon): wasichain-v<VERSION>-aarch64-apple-darwin.tar.gz
  • Linux x86_64: wasichain-v<VERSION>-x86_64-unknown-linux-gnu.tar.gz
  • Windows: use WSL and the Linux x86_64 archive

2. Install Rust for contract development

If you plan to build contracts locally, install Rust and the wasm32-wasip2 target:

rustup target add wasm32-wasip2

3. Install Docker for local devnets and node operation

Install Docker and Docker Compose if you want to run the local devnet or self-host node services.

4. Clone the chain repository

The examples, Docker Compose files, and contract source live in the chain repo:

git clone https://github.com/wasichain/chain.git
cd chain