This guide will help you set up your Linux environment for Rust development, focusing on the necessary steps to install Rust and the required dependencies for developing and validating on the Argochain network.
Before you begin, ensure your system is up to date and has the necessary tools installed. This guide uses Ubuntu as an example, but the commands can be adapted for other Linux distributions.
Open a terminal and update your package lists.
Install the essential packages:
Download and run the rustup
installation script to install Rust:
Follow the on-screen instructions to complete the installation.
To update your current shell to include Cargo (Rust's package manager), run:
Verify the Rust installation:
Set Rust to use the stable version by default and update to the latest version:
Add the nightly toolchain and the WebAssembly (wasm) target required for Substrate development:
Verify the configuration:
Now that Rust is installed and configured, you can compile an Argochain node.
Clone the Argochain repository:
Compile the Argochain node:
The compilation process may take several minutes.
To create a suitable development environment for Substrate on a Windows computer, you can use Windows Subsystem for Linux (WSL) to emulate a UNIX operating system. While UNIX-based systems like macOS or Linux offer better environments for building Substrate-based blockchains, using WSL can be a viable alternative. All code examples and command-line instructions in Substrate tutorials and guides are UNIX-based.
Ensure the following requirements are met:
Operating System: Microsoft Windows 10, version 2004 or later, or Windows 11
Internet Connection: Good broadband connection
Shell Access: Access to a terminal on your local computer
WSL enables you to emulate a Linux environment on a Windows computer, allowing you to use UNIX commands directly.
Open PowerShell or Command Prompt as an administrator.
Run the following command to enable WSL:
This command installs the required WSL 2 components, downloads the latest Linux kernel, and installs the Ubuntu Linux distribution by default.
To see other available Linux distributions, run:
Restart your computer to complete the installation.
Open the Ubuntu application from the Start menu.
Create a UNIX user account by providing a username and password.
Update the package list:
Install the required packages:
Download and install Rust:
Follow the prompts for default installation.
Update your shell to include Cargo:
Verify the Rust installation:
Set Rust to use the stable version by default and update:
Add the nightly toolchain and WebAssembly (wasm) targets:
Verify the configuration:
Now that Rust is installed and configured, you can compile an Argochain node.
Clone the Argochain repository:
Compile the node template:
The compilation process may take several minutes.
Your development environment is now configured for validation and staking on the Argochain network.
This guide will help you install Rust and set up a Substrate development environment on Apple macOS computers with either Intel or Apple M1 processors.
Ensure your computer meets the following requirements:
Operating System: macOS 10.7 Lion or later
Processor: At least 2GHz (3GHz recommended)
Memory: At least 8 GB RAM (16 GB recommended)
Storage: At least 10 GB available space
Internet: Broadband connection
If you don't have Homebrew installed, you should install it to manage packages on macOS.
Open the Terminal application.
Download and install Homebrew by running:
Verify Homebrew installation:
Update Homebrew:
Install required packages:
Download and run the rustup
installation script:
Follow the prompts for default installation.
Update your current shell to include Cargo:
Verify Rust installation:
Configure Rust to use the stable version and update:
Add the nightly toolchain and WebAssembly (wasm) targets:
Verify the configuration:
Now that Rust is installed and configured, you can compile a Substrate node.
Clone the Substrate node template repository:
Compile the node template:
The compilation process may take several minutes.
Your development environment is now set up for Substrate development.
Your local computer is ready for Substrate development activity. For further resources and guides, visit the Substrate Developer Hub.
Setting up a developer environment varies significantly between operating systems, so follow the specific instructions for your OS:
Windows: Use tools like PowerShell or WSL.
macOS: Utilize Terminal and Homebrew.
Linux: Rely on package managers like apt, yum, or dnf depending on your distribution.
Pay careful attention to the detailed steps for your OS to ensure a smooth setup.