Skip to main content

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:

  1. Install Massa station based on your OS:
    • Windows
    • MacOS
      • For Apple Silicon CPUs (M1, M2...), use ARM
      • For Intel CPUs (i5, i7...), use AMD
    • Linux
  2. Start Massa station using the icon tray. If you need help, this page can help.
  3. Configure your VPS and go to station home page.
  4. Install the node-manager plugin.
  5. Add your VPS details and click on "start".
  6. 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.

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 | 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

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: 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
    • Change default Rust to nightly: rustup default 1.72.0