See to try our new cutting edge Proof-of-Stake network with EVM smart contracts.
This documentation will be superseded by the rewritten documentation at

Head back to Documentation


QRL Testnet Node

This guide will explain the installation and configuration of a Testnet node running on the latest QRL code base.

Interacting with the QRL network while developing can present some complications, especially when dealing with live currency. There are situations where having a Testnet to interact with is beneficial. The QRL testnet is exactly that.

Our testnet network includes the latest code changes, improvements and releases that are in testing and at times, may be unstable. It is a testnet, after all.

Testnet will restart frequently as patches are made. Official postings will be made to alert users of these resets where achievable. Please join our Discord Server for announcements or to get in touch with the team.

There is no value associated with the Testnet QRL, It’s only used for testing and developing with the QRL.

Never use a QRL address on both networks! OTS keys should never be re-used, even on separate networks.

Testnet Installation

With the latest updates to the code, it is even easier to run a testnet node. Simply pass a command flag when the node is started and all of the required configuration and setup happens automatically. This should lower the bar for anyone wanting to run our node.

Additionally starting a node with the start_qrl --network-type testnet flag will create a new directory, placing all of the testnet chain sate files and other data into a newly created directory, ~/.qrl-testnet

This simplifies migration from testnet to a Main-Net node on the same system as there is no longer the need to clear out any contents to switch between networks.


The basic requirements for a QRL Testnet node are exactly the same as running a full node on Main-Net. These are requirements for the QRL node software to operate.

  • Support for AES-NI
  • Support for avx2 (Used by keccak library for hashing functions)
  • HDD with enough storage for the blockchain as it grows
  • Reliable network connection
  • Python 3.6
  • 64 bit processor

Install QRL

Below are abridged instructions for installing QRL on Ubuntu. These instructions are identical to the full node setup. Please refer to the QRL Node Install Doc for further information on installing the QRL Python Node.

# Update and Upgrade packages
sudo apt update && sudo apt upgrade -y

# Install Required dependencies
sudo apt-get -y install swig3.0 python3-dev python3-pip build-essential pkg-config libssl-dev libffi-dev libhwloc-dev libboost-dev cmake libleveldb-dev

## Install CMAKE version 3.10.3 manually
cd /opt && sudo wget && sudo tar zxvf cmake-3.10.3.tar.gz && cd cmake-3.10.3/ && sudo ./configure && sudo make -j2 && echo -e '## Adding cmake version 3.10.3\nPATH=$PATH:/opt/cmake-3.10.3/bin' >> ~/.bashrc && source ~/.bashrc

# Make sure setuptools is the latest
pip3 install -U setuptools

# Install QRL
pip3 install -U qrl

Once this is complete you can check the status of the QRL install by passing the qrl --version command. It should print the latest version that matches the Github Repo

Start The QRL Node

Now that we have QRL installed begin syncing the Testnet node.

start_qrl --network-type testnet

The Testnet node will sync the entire blockchain to your computer. after syncing the chain you will begin seeing blocks added.

Config.yml File

This file is automatically placed in the correct directory, no longer requiring any user interaction. You will find this in the ~/.qrl-testnet directory after starting the Testnet node for the first time.

The configuration file tells the node where to look for peers to connect to, what to expect for network settings, difficulty etc. Have a look at the Configuration Documentation for more information on other configuration options.

Below is an example of what you will find in the configuration file after starting the Testnet node. The details may change as the node is developed and the network is reset over time.

peer_list: [ "", "", "", "" ]
genesis_prev_headerhash: 'The Testnet Genesis'
genesis_timestamp: 1530004179
genesis_difficulty: 5000
db_name: 'testnet-state'

Genesis.yml File

This file is now created automatically when you start the Testnet node. Simply start the qrl node passing the new start_qrl --network-type testnet

Updating Testnet Nodes

If you are running a Testnet node you will need to keep up to date as we reset testnet periodically.

Each time the network is updated you will need to refresh some files and restart the node. Look for messages from the QRL team in the chat on Discord for updates to testnet.

Updating Is Simple

  1. Stop the node
  2. Update QRL pip3 install -U qrl
  3. Remove the ~/.qrl-testnet/data directory
  4. Remove the ~/.qrl-testnet/genesis.yml file
  5. Remove the ~/.qrl-testnet/config.yml file
  6. Restart the node using start_qrl --network-type testnet

The last command will pull down, and relocate the config.yml and genesis.yml files into the correct ~/.qrl-testnet directory with the latest Testnet configurations. This should start syncing the testnet network to your computer.

Verify that the details match what you expect issuing the qrl state command. The blockheight and network_id should be updated with the latest details and match what is shown on the Testnet Explorer.

Mining TestNet

We encourage people to set their nodes on Testnet to allow mining. This is a great way to earn some test QRL and helps the small network validate transactions and propagate blocks more efficiently.

  • Please note that most virtual private server providers dis-allow mining operations on shared resources. This may end up in a ban from the 3rd party system.
  • There is no need for mining pools and GPU mining on the testnet, save that hash power for the real network.
  • Testnet QRL is not traded, and is not worth any real value. This is only a test…

Enable Mining

To enable mining on your Testnet node, simply add the following to the ~/.qrl/config.yml file and restart the node to pickup the changes.

mining_enabled: True
mining_address: 'TESTNET_QRL_ADDRESS_HERE'
mining_thread_count: 0 

If you are in need of some QRL for testing on the TestNet, head over to the faucet and enter your Testnet address. You can find the link below. You will also find a link to the testnet wallet below, in case you need one of those too.

Some helpful links for the Testnet network. Since this is a completely separate blockchain, we need to use the testnet wallet and block explorer.

Still stuck? There's help over on Discord!