Install Rusk Manually

Node Installer

This page here is for advanced users looking for additional information or custom setups.

It is advised to use the Node installer to quickly launch your node on Dusk.

Rusk contains the software needed to run a Dusk node. Users can set specific compilation flags to configure their node for different roles, allowing it to perform tasks like participating in consensus, validating transactions, and storing historical data.

Rusk supports different feature setups:

• Provisioner : to stake and participates in consensus.
• Archive node : to store and serve historical data.
• Prover : to compute Zero-Knowledge Proofs.

The node software has been tested on x86-64/AMD64 and ARM architectures. The above node types have different hardware requirements, which can be found on their respective pages.

To install Rusk, you can either:

• Use the node installer (recommended)
• Build from source
• Use docker (not recommended for production environment)

Requirements

This page is tailored for Linux servers, if you are using another operating system you may encounter compatibility issues.

Node Installer

If you want to spin up a Provisioner node on the Nocturne testnet, you can use the node installer script. This installer will set up Rusk as a service, preconfigure parts of the node, and provide a couple of helper scripts.

You can install Rusk with the default mainnet configuration by pasting the following command in your terminal:

curl --proto '=https' --tlsv1.2 -sSfL https://github.com/dusk-network/node-installer/releases/latest/download/node-installer.sh | sudo bash

Node Installer

For more information on the Node Installer, such as networks and features you can set up — checkout the node-installer README

UFW and other configurations

The script may enable ufw and apply other configurations to your system. If you want to avoid this, you can disable ufw or build from source.

Build from source

Rusk can be built from source by following this guide.

Networking

As Dusk uses an ultra-efficient P2P UDP network protocol called Kadcast, the network requirements are minimal but should maintain symmetrical, stable, low-latency connections.

For external network connectivity, ensure that your firewall and router’s ports are forwarded correctly:

• 9000/udp: Required for Kadcast consensus messages.
• 8080/tcp: Optional HTTPS API for querying the node.

Note

The ports are configurable either as option to the node binary or by setting them in the configuration files. The node installer automatically configures the necessary ports.

Docker Installation

This guide will take you through the process using Docker, for running a local Dusk node.

Docker packages applications into containers that include all dependencies, ensuring a consistent runtime environment. This ensures that software always runs consistently, regardless of where it is installed.

Notice

The following guide is intended to help you set up a local node for testing and development purposes only. It is not recommended for production use, as there is no guide or explanation for running a production node within Docker. Docker is used here to facilitate convenient local testing and to provide developers with a dedicated node for API testing.

Prerequisites

1. 🐳 Docker: If you don’t have Docker installed, please follow the official guide
2. 🛜 Internet Connection: Required to download the Docker image and necessary files.
3. 🛠️ Git: Optional, but recommended. Useful for retrieving the node code. Git can be downloaded here
4. 💻 Terminal: To execute the steps in the Step-By-Step below, you will need to use a terminal application.
5. 🎛️ x86-AMD64: To create the Docker Image, a processor with the x86-AMD64 architecture is required.

Using DockerHub

If you want to quickstart using a prebuilt docker image, run the following command:

docker run -p 9000:9000/udp -p 8080:8080/tcp dusknetwork/node

Step-by-Step Instructions

1. Get the Dusk node files

There are two ways to get the software, cloning the repository using git, or simply downloading from github

git clone https://github.com/dusk-network/rusk.git

2. Build Docker Image

With Docker installed and the repository files obtained, let’s build the Docker image. Note that this can take 15 to 20 minutes.

The most up to date commands can be found in the readme of the repository

Troubleshooting Tips

• Installation Issues: Ensure your operating system is up-to-date, you have adequate permissions and all the necessary prerequisite software is installed.
• Network Errors: Check your internet connection and verify UDP ports are open if connecting to an external network.