System Requirements

Welcome to the Arch Network development guide. This page will walk you through setting up your development environment with all necessary dependencies. Please follow each section carefully to ensure a smooth setup process.

Overview

Before you begin development with Arch Network, you'll need to install and configure the following tools:

RequirementMinimum VersionDescription
RustLatest stableCore development language
DockerLatestContainer runtime for local node infrastructure
C++ Compilergcc/clangRequired for native builds
Node.jsv19+JavaScript runtime for SDK
Solana CLIv1.18.18Solana development tools
[Arch CLI]LatestArch Network development toolkit

Detailed Installation Guide

1. Install Rust

Rust is the primary development language for Arch Network programs.

# Install Rust using rustup
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Verify installation
rustc --version
cargo --version

💡 Note: Make sure you're using the stable channel throughout this book.

2. Install Docker

Docker is essential for running Arch's local node infrastructure.

  1. Download Docker Desktop from the Docker website
  2. Follow the installation wizard for your operating system
  3. Start Docker Desktop
  4. Verify installation:
docker --version

3. C++ Compiler Setup

MacOS Users

The C++ compiler comes pre-installed with Xcode Command Line Tools. Verify with:

gcc --version

If not installed, run:

xcode-select --install

Linux Users (Debian/Ubuntu)

Install the required compiler tools:

sudo apt-get update
sudo apt-get install gcc-multilib build-essential

4. Install Node.js

Node.js is required for working with the arch-typescript-sdk.

# Using nvm (recommended)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 19
nvm use 19

# Verify installation
node --version  # Should show v19.x.x or higher
npm --version

5. Install Solana CLI

The Solana CLI is required for program compilation and deployment.

sh -c "$(curl -sSfL https://release.solana.com/v1.18.18/install)"

⚠️ Important Notes:

  • Solana v2.x is not supported
  • You can use stable, beta, or edge channels instead of v1.18.18
  • Add Solana to your PATH as instructed after installation

Troubleshooting Solana Installation

If you installed Rust through Homebrew and encounter cargo-build-sbf issues:

  1. Remove existing Rust installation:
rustup self uninstall
  1. Verify removal:
rustup --version  # Should show "command not found"
  1. Perform clean Rust installation:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  1. Reinstall Solana:
sh -c "$(curl -sSfL https://release.solana.com/v1.18.18/install)"

6. Install Arch CLI

The Arch CLI provides essential development tools and a local development environment.

# Clone the repository
git clone https://github.com/arch-Network/arch-cli
cd arch-cli

# Install the CLI
cargo install --path .

# Verify installation
arch-cli --version

Features

The Arch CLI provides:

  • Local Arch Network development environment
  • Project setup and deployment tools
  • Example dapp with Arch functionality
  • Mini block explorer for transaction monitoring

Need Help?