Installing a node

Not

Right now 4 cores and 8 GB of RAM should be enough to run a node, but it might increase in the future. More info in the FAQ.

From binaries (simple installation)

If you just wish to run a Massa node without compiling it yourself, you can simply download the latest binary below and go the the next step: Running a node.

From source code (advanced installation)

Otherwise, if you wish to run a Massa node from source code, here are the steps to follow:

On Ubuntu / MacOS

  • on Ubuntu, these libs must be installed: sudo apt install pkg-config curl git build-essential libssl-dev libclang-dev cmake

  • on MacOS: brew install llvm cmake

  • install rustup: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

  • configure path: source $HOME/.cargo/env

  • check rust version: rustc --version

  • install nigthly: rustup toolchain install nightly-2023-02-27

  • set it as default: rustup default nightly-2023-02-27

  • check rust version: rustc --version

  • clone this repo: git clone --branch testnet https://github.com/massalabs/massa.git

On Windows

Set up your Rust environment

  • On Windows, you should first follow the indications from Microsoft to be able to run on a Rust environment here.

    • Install Visual Studio (recommended) or the Microsoft C++ Build Tools.

    • Once Visual Studio is installed, click on C++ Build Tool. Select on the right column called “installation details” the following packages:

      • MSCV v142 – VS 2019

      • Windows 10 SDK

      • C++ CMake tools for Windows

      • Testing Tools Core Feature

    • Click install on the bottom right to download and install those packages

  • Install NASM : https://www.nasm.us/pub/nasm/releasebuilds/2.16.01/ choose win32 or win64 folder depending on your architecture and download then launch the installer.

  • Install Chocolatey and run: choco install llvm cmake protoc

  • Install Rust, to be downloaded here

  • Install Git for windows, to be downloaded here

  • Install install protoc in your PATH, to be downloaded here

Clone the Massa Git Repository

  • Open Windows Power Shell

    • Clone the latest distributed version: git clone --branch testnet https://github.com/massalabs/massa.git

    • Change default Rust to nightly: rustup default nightly-2023-02-27