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:
Requirement | Minimum Version | Description |
---|---|---|
Rust | Latest stable | Core development language |
C++ Compiler | gcc/clang | Required for native builds |
Solana CLI | v1.18.18 | Solana development tools |
Arch Network CLI | Latest | Arch 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. 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 jq
3. Install Solana CLI
The Solana CLI is required for program compilation and deployment.
sh -c "$(curl -sSfL https://release.anza.xyz/v2.1.13/install)"
⚠️ Important Notes:
- Add Solana to your PATH as instructed after installation
Troubleshooting Solana Installation
If you installed Rust through Homebrew and encounter cargo-build-sbf
issues:
- Remove existing Rust installation:
rustup self uninstall
- Verify removal:
rustup --version # Should show "command not found"
- Perform clean Rust installation:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
- Reinstall Solana:
sh -c "$(curl -sSfL https://release.solana.com/v1.18.18/install)"
4. Install Arch Network CLI
The Arch Network CLI provides essential development tools and a local development environment.
# Download the appropriate CLI binary for your architecture from:
# https://github.com/Arch-Network/arch-node/releases/latest
# For example, for macOS with Apple Silicon:
curl -L -o cli https://github.com/Arch-Network/arch-node/releases/latest/download/cli-aarch64-apple-darwin
chmod +x cli
sudo mv cli /usr/local/bin/
# Verify installation
cli --version
Features
The Arch Network CLI provides:
- Local validator node for development
- Program deployment and management
- Account and transaction management
- Block data and program logging
- Group key and network controls
Need Help?
- Check our Troubleshooting Guide
- Join our Discord dev-chat for community support
- Review the Arch Network CLI repo documentation
- Ensure all version requirements are met