Skip to content

Upgrade your node

A network may be occasionally upgraded with new features and performance optimizations.

To make the upgrade process as flawless as possible, the node installer script may be updated from time to time. This script can be ran in a non-destructive way, meaning it changes only what is needed. It will gracefully shut down Rusk for you.

In the case of migrating to a newer version of Nocturne, please see the Nocturne Reset section.

How to Upgrade

To upgrade to the latest Nocturne version, run:

Terminal window
curl --proto '=https' --tlsv1.2 -sSfL https://github.com/dusk-network/node-installer/releases/download/v0.3.5/node-installer.sh | sudo sh

Once it’s done and gives no errors, start Rusk again:

Terminal window
service rusk start

If everything is up and running again, query the node a couple of times to see if the block height is progressing:

Terminal window
ruskquery block-height

Or keep an eye on the logs to see if it’s making and accepting new blocks:

Terminal window
tail -F /var/log/rusk.log

If you see new blocks being accepted, you’re up and running again. Is your node stuck, or are you not sure if it is?

You can see the status of the Rusk service here:

Terminal window
service rusk status

If it is not running after starting it, and reports an error, you can check your logs to see if something is wrong, like a wrong password or no peers being found:

Terminal window
tail -n 30 /var/log/rusk.log

Unable to figure it out yourself? Visit our Node Runner Troubleshooting on Discord.

If everything else fails, check out the manual resync instructions.

Nocturne Reset

  1. To reset the state of Nocturne, download the latest version of our installer:
Terminal window
curl --proto '=https' --tlsv1.2 -sSfL https://github.com/dusk-network/node-installer/releases/download/v0.3.5/node-installer.sh | sudo sh
  1. Reset all the data on your node:
Terminal window
ruskreset

Press Y to accept the deletion of all the state.

  1. Start Rusk:
Terminal window
service rusk start
  1. Check if you’re already staking by running:
Terminal window
rusk-wallet stake-info

If you already have DUSK staked, wait until the chain starts producing blocks. You can check our explorer to see if the chain is progressing or when it will produce the genesis block.

  1. If you do not have testnet DUSK, request nDUSK from the faucet.

  2. Stake your nDUSK:

Terminal window
rusk-wallet stake --amt 1000 # Or however much you want to stake