Installing a node
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 Massa station (simplest installation)
If you wish to run a Massa node with a couple of clicks only, you can download Massa station app and activate the node-manager plugin. This will enable you to configure, install, start and even update a node using a simple graphical interface. For that, there are 5 steps to follow:
- Install Massa station based on your OS:
- Start Massa station using the icon tray. If you need help, this page can help.
- Configure your VPS and go to station home page.
- Install the node-manager plugin.
- Add your VPS details and click on "start".
- You're now a Massa node-runner!
If you have trouble following this procedure, feel free to open a question describing your problem.
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 to the next step: Running a node.
- Windows executable
- Linux binary - only works with libc2.28 and higher (for example Ubuntu 20.04 and higher)
- MacOS binary
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 rust stable version:
rustup toolchain install 1.72.0
- set it as default:
rustup default 1.72.0
- 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
- Install Rust, to be downloaded here
- Install Git for windows, 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 1.72.0
- Clone the latest distributed version: