QRL WSL / Ubuntu Node Guide

Detailed tutorial guides created by contributors.
Post Reply
Site Admin
Site Admin
Posts: 6
Joined: Fri Jun 18, 2021 6:27 am
Location: TX
United States of America

QRL WSL / Ubuntu Node Guide

Post by Administrator »

QRL Node Install guide for Windows Subsystem for Linux (WSL) or Ubuntu

For non-windows users, it is recommended to use this guide on Kubuntu which you can get here.


If you do not require windows, it is recommended to install a flavor of ubuntu, such as kubuntu or lubuntu and start at step 5.

Ubuntu boot issue: If, upon trying to boot up a flash drive of ubuntu created with rufus and it says it failed to initialize graphics on boot, simply type help and hit enter, it will continue the install as normal.

WSL FAQ (Useful info, if you need it): https://docs.microsoft.com/en-us/windows/wsl/faq


For Windows:
1. Install WSL ( https://docs.microsoft.com/en-us/window ... -of-choice )

Run powershell as administrator and run this command (you can copy and paste -- to paste it into the command line, you can right click):

Code: Select all

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
3. Download Ubuntu


This will cause the <distro>.appx package to download, copy it over to your Documents.
You should rename it to Ubuntu, so that it goes from this: Ubuntu_2004.2020.424.0_x64.appx

to this: Ubuntu.appx

4. Install and Run Ubuntu

Once the distribution has been downloaded, renamed and copied to your documents folder: navigate via powershell to the documents folder (via command: "cd c:\Users\YourUserName\Documents") containing the download and run the following command in that directory.

We're going to install the .appx file by changing it to a zip file. https://docs.microsoft.com/en-us/window ... -on-server

So run the command:

Code: Select all

Rename-Item .\Ubuntu.appx .\Ubuntu.zip
Expand-Archive .\Ubuntu.zip .\Ubuntu
After it extracts, open the Documents\Ubuntu folder in explorer (not powershell) and right-click run the ubuntu.exe app as an admin.

4a. Create User account for Ubuntu

After it installed, I simply hit enter and then it asked me to create a User account with pass.

Fill that information and write it down just in case.

5. Using Ubuntu: (If only using Ubuntu, start here)

First, we'll want to install python 3.8 so run this command (it will ask for your password, input it)

Code: Select all

sudo apt install python3.8

Code: Select all

sudo apt update

Code: Select all

sudo apt upgrade -y
6. Install all required dependencies:

Code: Select all

sudo apt-get -y install swig3.0 python3.8-dev python3-pip build-essential pkg-config libssl-dev libffi-dev libhwloc-dev libboost-dev cmake
7. Install setuptools, service-identity and launchpadlib

Code: Select all

pip install -U setuptools
Now install service identity

Code: Select all

pip3 install -U service-identity==17.0.0
Now install launchpadlib if you got the error about testresources not found:

Code: Select all

pip install -U launchpadlib
8. Install QRL

Code: Select all

pip install -U qrl
Windows users: If you haven't already restarted since installing WSL and Ubuntu, do so now then continue from this point.

9. Run QRL

Code: Select all


Code: Select all

If it says command not found, you must use the command from a terminal opened from the directory of the script (or reference the path in the command).
If all went well, it should run and sync, it will create a data folder in the root > home directory of the Ubuntu install:
(For my install, my ubuntu folder is in my Documents folder -- this is the easiest to find)

Windows Users: C:\Users\Administrator\Documents\Ubuntu\rootfs\home\*YourUbuntuUserName*\.qrl

For Ubuntu, it will be here: /home/.qrl (You will need to turn on "View hidden files")

Stop it with ctrl+c and navigate your browser to this website: https://qrl.co.in/chain/#mainnet-chain

Download the mainnet chain state file here:

After it downloads (It is almost 12gb, give it time) you'll need 7zip or similar so download it here if you don't have it already:

Navigate your explorer file browser to C:\Users\Administrator\Documents\Ubuntu\rootfs\home\*YourUbuntuUserName*\.qrl\data\state

Utilize 7zip to open the .tar.gz which will reveal another .tar inside, extract that folder to the QRL directory > data folder where the other state folder is: C:\Users\Administrator\Documents\Ubuntu\rootfs\home\*YourUbuntuUserName*\.qrl\data
For Ubuntu: /home/.qrl/data

Replace any files it asks.

Your blockchain files should now be closely synced with the LIVE chain, saving you more than a weeks worth of syncing time. These chain files are provided by a QRL team member, so they should be safe. If you prefer, you can sync the entire file.

Now go here

and find this link near the top

right click it and save content as, save this config file into the .qrl directory:

You'll have to edit it with notepad or notepad++ ( https://github.com/notepad-plus-plus/no ... taller.exe ), so open it with either one and edit these lines, removing the # from infront of them and adding your mining wallet address:

mining_enabled: Enabled
mining_address: 'Your Wallet Address'
mining_thread_count: 0 # 0 to auto detect thread count based on CPU/GPU number of processors

If you don't have a wallet, you can generate one with the mobile app, the desktop wallet ( viewforum.php?f=37 ), or the web wallet ( viewforum.php?f=23 ).

If you have permissions issues [Errno13], run this command:

Code: Select all

sudo chmod -R a+rwx \.qrl\
Finally, run start_qrl and it should work!
(For Ubuntu it might be this script instead: /home/.local/bin/qrl_start)
You should now have a syncing/synced, mining QRL node!

If you would like to automatically start the node after computer reboot:
Windows: create a batch file with this command and add it to the task scheduler

Code: Select all

start cmd /k C:\<path to ubuntu>\ubuntu2004.exe run /home/<user>/.local/bin/start_qrl
Ubuntu (Kubuntu): System Settings > Startup and Shutdown > Autostart > Script File > /home/yourusername/.local/bin/start_qrl.py or qrl_start.py (either or).

If you have any issues, carefully read through this tutorial again and all of the source information and then contact #support on the discord ( https://discord.com/invite/RcR9WzX )!