Updating the Q Root Node Client

Linux Server

This guide will show you step-by-step how to update your root node to the latest Q client version, in this example version v1.3.11. You'll need to change some root node files and settings, so get ready to open your server console and type in some commands. Assuming that you are operating a Linux server, here is how:

1. Connect to your root node server. How you do this might differ depending on your setup. For instance, Mac users can use the “terminal” application to set up an SSH connection to their server instance, while Windows users can use PuTTy or Powershell. You could also use your server hosting provider's management system to access your server console. If you experience problems during this step, open a ticket on Discord.
2. Go to the /rootnode directory. To accomplish this task, copy and paste the following command into your console and press enter to execute it:

cd mainnet-public-tools/rootnode

3. Open the .env file by executing this command (you might need to add sudo before that, depending on what rights your current user has):

nano .env

4. Update the docker image in your .env file. Use the arrow keys to navigate to:
   ...QCLIENT_IMAGE=qblockchain/q-client:v1.3.5 ... and change to ... QCLIENT_IMAGE=qblockchain/q-client:v1.3.11 ... If your current q-client version is less than v1.3.5, you still update it to the latest Q client version. Please note that starting with version v1.3.5, the tag naming convention has changed to include a v in the version tag. So make sure you enter "...q-client:v1.3.11".
5. Save your changes by pressing CTRL+O, press enter, and close the nano editor by pressing CTRL+X.
6. You should now be back in the mainnet-public-tools/rootnode directory. Pull and replace the latest docker image with this command (you might need to add sudo before that):

docker-compose pull

7. Restart your root node client with new images and settings using this command (you might need to add sudo before that)

docker-compose down -t 60 && docker-compose up -d

Your root node should initiate a restart and begin synchronization with the mainnet. To check the status of your root node, visit: Q stats. You can search for your node's q-stats name in the search bar on the left. If you do not know your q-stats name, please reach out via Discord. Once you find your node on q-stats, the most important things to look for are the number of peers and the last block number. Over time, your node will find more peers and start to catch up with the current block number. It may take some time for your root node to fully synchronise with mainnet. If your root node is still red or yellow after a few hours, please open a ticket on Discord.

Windows Server

This guide will show you step-by-step how to update your root node to the latest Q client version, in this example version v1.3.11. You'll need to change some root node files and settings, so get ready to open Powershell and type in some commands. Assuming that you are operating on Windows, here is how:

1. Open the Docker Desktop application and ensure that it is running in the background while executing the following commands.

2. Open Windows File Explorer and navigate to your root node directory. An exemplary file path could look like this: C:\your-node-directory\mainnet-public-tools\rootnode

3. Open the .env file with a text editor of your choice (e.g. "Editor" - the default text editor on Windows).

4. Update the docker image in your .env file. Change …”QCLIENT_IMAGE=qblockchain/q-client:v1.3.5”… to …”QCLIENT_IMAGE=qblockchain/q-client:v1.3.11”… Note: If your current q-client version is less than v1.3.5, you still update it to the latest Q client version. Please note that starting with version v1.3.5, the tag naming convention has changed to include a v in the version tag. So make sure you enter "...q-client:v1.3.11".

5. Save your changes and close the file

6. Search for the Powershell application on Windows.

7. Right CLICK on Powershell, run with administrator privileges, press "YES".

8. Navigate to the root node directory by executing the following command:

cd C:\your-node-directory\mainnet-public-tools\rootnode

Note: Please modify the command to use the correct file path: cd \insert\correct\path. This file path should be the same one you used in step two to find the root node directory.

9. Pull and replace the latest docker image by executing this command:

docker-compose pull

10. Restart your root node client with the new image and config by executing this command:

docker-compose down -t 60 && docker-compose up -d

11. You can now close the Docker Desktop and Powershell application.

Your root node should initiate a restart and begin synchronization with the mainnet. To check the status of your root node, visit: https://stats.q.org/ at least two minutes after restarting. You can search for your node's q-stats name in the search bar on the left.