Running a node

From binaries (simple installation)

Simply run the binaries you downloaded in the previous step:

  • Open the massa-node folder and run the massa-node executable

  • Open the massa-client folder and run the massa-client executable

On Ubuntu / MacOS

Configure the node

Default configuration is available here.

You can override the default configuration via massa-node/config/config.toml file.

Start the node

On a first window:

cd massa/massa-node/

Launch the node, on Ubuntu:

./massa-node -p <PASSWORD> |& tee logs.txt

Replace <PASSWORD> with a password that you will need to keep to restart your node You should leave the window opened.

Start the client

On a second window:

cd massa/massa-client/

Then:

./massa-client -p <PASSWORD>

Replace <PASSWORD> with a password that you will need to keep to restart your client

From source code (advanced installation)

On Ubuntu / MacOS

Start the node

On a first window:

cd massa/massa-node/

Launch the node, on Ubuntu:

RUST_BACKTRACE=full cargo run --release -- -p <PASSWORD> |& tee logs.txt

Replace <PASSWORD> with a password that you will need to keep to restart your node

Or, on macOS:

RUST_BACKTRACE=full cargo run --release -- -p <PASSWORD> > logs.txt 2>&1

Replace <PASSWORD> with a password that you will need to keep to restart your node You should leave the window opened.

Start the client

On a second window:

cd massa/massa-client/

Then:

cargo run --release -- -p <PASSWORD>

Replace <PASSWORD> with a password that you will need to keep to restart your client Please wait until the directories are built before moving to the next step.

On Windows

Start the Node

  • Open Windows Power Shell or Command Prompt on a first window

    • Type: cd massa

    • Type: cd massa-node

    • Type: cargo run --release -- -p <PASSWORD>

Replace <PASSWORD> with a password that you will need to keep to restart your node You should leave the window opened.

Start the Client

  • Open Windows Power Shell or Command Prompt on a second window

    • Type: cd massa

    • Type: cd massa-client

    • Type: cargo run --release -- -p <PASSWORD>

Replace <PASSWORD> with a password that you will need to keep to restart your client Please wait until the directories are built before moving to the next step.

Warning

In case of crash of the rust compiler or at runtime, please do not report bugs to the rustlang/rust repository, but open an issue on massa instead. We will triage the issues and open them on the rust side if they are valid. This avoids polluting the main rust repository with many reports of the same error.