Head back to Documentation


Running A QRL Full Node

Running a full node is easy and helps strengthen the QRL network. You can run QRL on most operating systems, though Ubuntu 16.04 is recommended.

You should have a basic understanding of the CLI before attempting to set this up, it isn’t really all that tough. Every answer you need is out there already, search online or drop into the QRL chat for help.

Plan For The Future

Make sure the computer you are using has enough power to handle the load of the mining operation. Low power computers do not run full nodes very well and are not recommended.

You will also need enough storage to keep the chain as it grows in the future. A few hundred gig HDD/SSD to sync the chain on long term to be safe.


If you build on a small VPS or other light weight hardware you may run into issues building the package. Make sure you have enough *RAM and enable SWAP if needed. AES-NI is required for cryptographic functions.*

Minimum Requirements

  • *Most Linux / Unix based systems
  • Any x86 or x64 based processor
  • Support for AES-NI
  • Enough HDD space for the blockchain growth.

Install on Linux

Ubuntu 16.04


Update your system ensuring you have the latest packages.

# Issue the following command to update software
sudo apt update && sudo apt upgrade -y


# Install the required packages for QRL
sudo apt-get -y install swig3.0 python3-dev python3-pip build-essential cmake pkg-config libssl-dev libffi-dev libhwloc-dev libboost-dev


Fedora 27 install instructions

dnf update 
# Install required packages
dnf install swig cmake gcc gcc-c++ redhat-rpm-config python3-devel python-devel hwloc-devel boost-devel

Install on MacOS

To build in OSX Please install brew if you have not already.

# Install brew with
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" 

This will prompt you through a few questions while it installs.

Having Issues? Please follow the instructions found at the brew main page: https://brew.sh/

# Update brew
brew update
brew install cmake python3 swig boost hwloc

Install QRL

The procedure to installing the QRL full node for a Mac is the exact same as it is in Linux. Once you have the Brew Packages installed proceed through the guide

Install on Windows 10

*Windows support in the current version is limited. An alternative is to use an Ubuntu VM (virtualbox), or install Ubuntu using the Linux Subsystem for Windows.

Ubuntu on Linux Subsystem for Windows (WSL)

You can run a full node in Windows utilizing the Windows Subsystem for Linux. There are a ton of guides out there on setting this up. Here are a few links to get you going.

The Windows Subsystem for Linux (WSL) is a new Windows 10 feature that enables you to run native Linux command-line tools directly on Windows, alongside your traditional Windows desktop and modern store apps.

You can follow these instructions to install Ubuntu using Linux Subsystem,

Installing Ubuntu in Windows 10

Install QRL

The procedure to installing the QRL full node in WSL is the exact same as it is in Linux or MacOS. Once you have the WSL system setup and running Ubuntu proceed through the guide

A native Windows solution is in the works

Install QRL

Now that we have a freshly updated system, the installation of QRL is a breeze, QRL uses python3 to install. Using the Python3 package installer pip3 we will install QRL.

# Install the qrl Package.
pip3 install -U qrl

This will install the QRL package and any required dependencies. Once this is done you can create a new wallet.

Creating a Wallet

Create a new wallet using the qrl command. For a full list of options run:

qrl --help

Create New Wallet

# Create a new wallet
qrl wallet_gen

Get Mnemonic/hexseed

# Get mnemonic phrase and hexseed
qrl wallet_secret

Recover QRL Wallet

If you lose your wallet, the mining rig catches fire, or worse, you still have the ability to recover your Quanta as long as you’ve saved the hexseed or mnemonic phrase.

# Options:
#   --seed-type [hexseed|mnemonic]
#   --help      Show this message and exit.

qrl wallet_recover --seed-type mnemonic

Start QRL Node

Now that we have a QRL wallet address, we can start_qrl. This will begin the qrl node and start mining. If you have passed any command line options they will override the default settings. you can set the mining threads etc.

You must give the node an address to begin mining on.

# start qrl
start_qrl --miningCreditWallet YOUR_QRL_ADDRESS

Check out all the options with a simple start_qrl --help

Using screen you can run in the background and reconnect later. You may need to install screen.

# run in background
screen -d -m start_qrl --miningCreditWallet YOUR_QRL_ADDRESS

You can see the progress in the ~/.qrl/qrl.log file.

# watch the action with 
tail -f ~/.qrl/qrl.log

Config File

You can alter the default settings of the node by simply adding a file to your ~/.qrl folder

# Create and edit the config.yml file
nano ~/.qrl/config.yml

Add the following to the file. These are all default settings, uncomment to edit the parameters.

# ======================================
#    Mining Configuration
# ======================================
# mining_enabled: True
# mining_thread_count: 0  # 0 to auto detect thread count based on CPU/GPU number of processors

# ======================================
#    Ephemeral Configuration
# ======================================

# accept_ephemeral: True
# outgoing_message_expiry: 90 

# Cache Size
# lru_state_cache_size: 10
# max_state_limit: 10

# ======================================
#    P2P Configuration
# ======================================
# enable_peer_discovery: True  # Allows to discover new peers from the connected peers
# peer_rate_limit: 500  # Max Number of messages per minute per peer

# ntp_servers: pool.ntp.org
# ntp_servers:
#   - pool.ntp.org
#   - ntp.ubuntu.com
# ban_minutes: 20              # Allows to ban a peer's IP who is breaking protocol

# max_peers_limit: 100  # Number of allowed peers
# chain_state_timeout: 180
# must be less than ping_timeout
# chain_state_broadcast_period: 30

# ======================================
#    Directory Configuration
# ======================================
## The users ~/.qrl/ directory  
#qrl_dir : /home/{USER}/.qrl  
## The users ~/.qrl/data/ directory  
#data_dir : /home/{USER}/.qrl/data  
## QRL Loging location ~/.qrl/qrl.log  
#log_path : /home/{USER}/.qrl/qrl.log  
## The users ~/.qrl/wallet/ directory  
#wallet_staking_dir : /home/{USER}/.qrl/wallet 

# qrl_dir: os.path.join(expanduser("~"), ".qrl")
# data_dir: os.path.join(qrl_dir, "data")
# config_path: os.path.join(qrl_dir, "config.yml")
# log_path: os.path.join(qrl_dir, "qrl.log")
# wallet_staking_dir: os.path.join(qrl_dir, "wallet")

# mining_pool_payment_wallet_path: os.path.join(qrl_dir, 'payment_slaves.json')  # Only for mining Pool

# ======================================
# ======================================
# slaves_filename: 'slaves.json'

# wallet_dir: os.path.join(qrl_dir)

Please add any issues found in GitHub If you need help jump into the Discord Chat

Node Commands

Some Handy Commands to query against your node.

screen -d -m start_qrl --miningCreditWallet YOUR_QRL_ADDRESS   # This will start QRL in a screen session.
tail -f ~/.qrl/qrl.log          # Show activity in qrl.log

# Print found blocks. If empty your node has not found anything yet.
grep Solution Found ~/.qrl/qrl.log

# Prints how many blocks you have found (count of won blocks)
grep `Solution Found` ~/.qrl/qrl.log |wc -l   

QRL Help

You can get this list of help from the command line by simply entering

qrl --help

You can get more detail from a sub catigory by entering

qrl wallet_seceret --help
qrl --help

Usage: cli.py [OPTIONS] COMMAND [ARGS]...

  QRL Command Line Interface

  -r, --remote        connect to remote node
  --host TEXT         remote host address             []
  --port_pub INTEGER  remote port number (public api) [9009]
  --port_adm INTEGER  remote port number (admin api)  [9009]* will change
  --wallet_dir TEXT   local wallet dir
  --json              output in json
  --version           Show the version and exit.
  --help              Show this message and exit.

  collect            Collects and returns the list of encrypted...
  send_eph_message   Creates & Push Ephemeral Message :param ctx:...
  slave_tx_generate  Generates Slave Transaction for the wallet
  state              Shows Information about a Node's State
  token_list         Create Token Transaction, that results into...
  tx_inspect         Inspected a transaction blob
  tx_latticepk       Create Lattice Public Keys Transaction
  tx_prepare         Request a tx blob (unsigned) to transfer from...
  tx_sign            Sign a tx blob
  tx_token           Create Token Transaction, that results into...
  tx_transfer        Transfer coins from src to dst
  tx_transfertoken   Create Token Transaction, that results into...
  wallet_add         Adds an address or generates a new wallet...
  wallet_gen         Generates a new wallet with one address
  wallet_ls          Lists available wallets
  wallet_recover     Recovers a wallet from a hexseed or mnemonic...
  wallet_secret      Provides the mnemonic/hexseed of the given...
start_qrl --help

usage: start_qrl.py [-h] [--mining_thread_count] [--quiet]
                    [--datadir DATA_DIR] [--no-colors]
                    [-l {DEBUG,INFO,WARNING,ERROR,CRITICAL}]
                    --miningCreditWallet MINING_CREDIT_WALLET

QRL node

optional arguments:
  -h, --help            show this help message and exit
  --mining_thread_count, -m
                        Number of threads for mining
  --quiet, -q           Avoid writing data to the console
  --datadir DATA_DIR, -d DATA_DIR
                        Retrieve data from a different path
  --no-colors           Disables color output
                        Set the logging level
required arguments:                        
  --miningCreditWallet MINING_CREDIT_WALLET
                        QRL Wallet address on which mining reward has to be

Still stuck? There's help over on Discord!