Installation

Rust

Go here to install Rust.

Solana

Go here to install Solana and then run solana-keygen new to create a keypair at the default location. Arcium uses this keypair to run your program tests.

Yarn

Go here to install Yarn.

Anchor

Go here to install Anchor.

Docker & Docker Compose

Go here to install Docker and here to install Docker Compose. To test correct installation, make sure docker compose (and not docker-compose) is installed by running docker compose --version.

Installing using the Arcium version manager (arcup)

arcup is a tool for managing versioning of the arcium tooling (including the cli and MPC node). More info on it can be found here. It will require the same dependencies as building from source.

Install arcup. We currently support 4 pre-built targets, listed below. We do not support Windows at the moment.

• aarch64_linux

• x86_64_linux

• aarch64_macos

• x86_64_macos

You can install it by replacing <YOUR_TARGET> with the target you want to install, and running the following command:

Arch Linux

TARGET=aarch64_linux && curl "https://bin.arcium.com/download/arcup_${TARGET}_0.2.0" -o ~/.cargo/bin/arcup && chmod +x ~/.cargo/bin/arcup

x86 Linux

TARGET=x86_64_linux && curl "https://bin.arcium.com/download/arcup_${TARGET}_0.2.0" -o ~/.cargo/bin/arcup && chmod +x ~/.cargo/bin/arcup

Apple Silicon

TARGET=aarch64_macos && curl "https://bin.arcium.com/download/arcup_${TARGET}_0.2.0" -o ~/.cargo/bin/arcup && chmod +x ~/.cargo/bin/arcup

Intel Mac

TARGET=x86_64_macos && curl "https://bin.arcium.com/download/arcup_${TARGET}_0.2.0" -o ~/.cargo/bin/arcup && chmod +x ~/.cargo/bin/arcup

Install the latest version of the CLI using arcup:

arcup install

Verify the installation.

arcium --version

Issues

Installation might fail due to a variety of reasons. This section contains a list of the most common issues and their solutions, taken from anchor's installation guide.

Missing dependencies

On Linux systems you may need to install additional dependencies. E.g. on Ubuntu:

For Linux systems:

sudo apt-get update && sudo apt-get upgrade && sudo apt-get install -y pkg-config build-essential libudev-dev libssl-dev

Incorrect $PATH

Rust binaries, including arcup and arcium, are installed to the ~/.cargo/bin directory. Since this directory is required to be in the PATH environment variable, Rust installation tries to set it up automatically, but it might fail to do so in some platforms.

To verify that the PATH environment variable was set up correctly, run:

which arcium

the output should look like (with your username):

/home/user/.cargo/bin/arcium