Let's start with the installation of the Linera development tools.


The Linera toolchain consist of two crates:

  • linera-sdk is the main library to program Linera applications in Rust. It also includes the Wasm test runner binary linera-wasm-test-runner.

  • linera-service defines four binaries:

    • linera -- the main client tool, to operate user wallets,
    • linera-proxy -- the Linera proxy, which acts as an ingress for validators,
    • linera-server -- the Linera workers behind the proxy,
    • linera-db -- a command line tool to manage persistent storage.

OS Support

The Linera client and validators run as a set of native binaries. Below is a matrix of supported operating systems.

Linux x86 64-bitMac OS (M1 / M2)Mac OS (x86)Windows
✓ Main platform✓ Working✓ WorkingUntested


The required software may installed as follows on Linux:

  • Rust and Wasm

    • curl --proto '=https' --tlsv1.2 -sSf | sh
    • rustup target add wasm32-unknown-unknown
  • Protoc

    • curl -LO
    • unzip -d $HOME/.local
    • If ~/.local is not in your path, add it: export PATH="$PATH:$HOME/.local/bin"
  • On certain Linux distributions, you may have to install development packages such as g++, libclang-dev and libssl-dev.

For MacOS, see the installation section on GitHub.

Installing from

You may install binaries with

cargo install linera-sdk
cargo install linera-service

and use linera-sdk as a library for Linera Wasm applications:

cargo add linera-sdk

Installing from GitHub

Download the source from GitHub:

git clone

To install the Linera toolchain locally from source, you may run:

cargo install --path linera-sdk
cargo install --path linera-service

Alternatively, for developing and debugging, you may instead use the binaries compiled in debug mode, e.g. using export PATH="$PWD/target/debug:$PATH".

This manual has been tested against the following commit of the repository:


Bash helper (optional)

Consider adding the output of linera net helper to your ~/.bash_profile to help with automation.

Getting help

If installation fails, reach out to the team (e.g. on Discord) to help troubleshoot your issue or create an issue on GitHub.