This repository contains an easy to use installer to run a Dusk node for our ITN program. For more information on how to participate, see the node running guide on our wiki.
- Ubuntu 22.04 LTS x64
- OpenSSL 3
This installer is specifically built for Ubuntu 22.04 x64. It might work on older or newer versions.
The installer comes with the following packages:
- Rusk service
- Rusk wallet CLI
The configuration files, binaries, services and scripts can be found in /opt/dusk/
.
The log files can be found in /var/log/rusk.log
and /var/log/rusk-recovery.log
.
ℹ️ To run the latest release of the ITN installer execute the following command:
curl --proto '=https' --tlsv1.2 -sSfL https://github.com/dusk-network/itn-installer/releases/download/v0.1.7/itn-installer.sh | sudo sh
curl --proto '=https' --tlsv1.2 -sSfL https://raw.githubusercontent.com/dusk-network/itn-installer/main/itn-installer.sh | sudo sh
The installer comes with sane defaults, only requiring minimal configuration. Before the Rusk service can be started, the CONSENSUS_KEYS
and DUSK_CONSENSUS_KEYS_PASS
need to be provided.
The CONSENSUS_KEYS
can be either moved to /opt/dusk/conf/
from another system or generated on the node itself and moved there.
To generate the provisioner keys locally, run rusk-wallet
and either create a new wallet or use a recovery phrase with rusk-wallet restore
.
To generate and export the provisioner key-pair and put the .keys
file in the right directory with the right name, copy the following command:
rusk-wallet export -d /opt/dusk/conf -n consensus.keys
Run the following command and it will prompt you to enter the password for the consensus keys file:
sh /opt/dusk/bin/setup_consensus_pwd.sh
Everything should be configured now and the node is ready to run. Use the following commands:
service rusk start
Check the status of the Rusk service by running:
service rusk status
To significantly reduce the time required to sync your node, you can use the /opt/dusk/bin/download_state
command. This command stops your node and replaces its current state with the latest published state from one of Dusk's archival nodes.
-
Stop your node (if it's running):
service rusk stop
-
Execute the fast sync command:
/opt/dusk/bin/download_state
Follow the prompts to confirm the operation.
-
Restart your node:
service rusk restart
This process will ensure your node is up-to-date with the latest blockchain state, allowing you to sync faster and get back to participating in the network in less time.
Check if your node is syncing, processing and accepting new blocks:
tail -F /var/log/rusk.log | grep "block accepted"
To check the latest block height:
ruskquery block-height