Skip to content
LEARN DEVELOPER NODE OPERATOR GRANTS

Node Upgrade

We will occasional upgrade and patch Nocturne with new features and patches to improve the overall network.

To make the upgrade process as flawless as possible, we will update the node installer script 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.

Are you migrating from Nocturne 1 to Nocturne 2? See Nocturne Reset.

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.0/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.0/node-installer.sh | sudo sh
  1. Reset all the data on your node:
Terminal window
ruskreset
  1. Start Rusk:
Terminal window
service rusk start
  1. Check if your staking rewards are in your wallet:
Terminal window
rusk-wallet stake-info --reward

  1. To claim your rewards, request nDUSK from the faucet. A guide can be found here.

  2. Withdraw your staking rewards:

Terminal window
rusk-wallet withdraw
  1. Stake your nDUSK:
Terminal window
rusk-wallet stake --amt 1000 # Or however much you want to stake