How to setup your node for Testnet

The testnet node is the go-to tool for developers and testers. Installing a testnet node is pretty easy but there are a few pitfalls you must pay attention to.

Get the right binary

The testnet receives uses the last test version of the gqdc node binary. This means that the version of the testnet node might not match the version of the main-net node. Please first check that the version you are running is the right one and update it if necessary.

The latest Test version of the binary is available from here:

Starting from Quadrans node self-installer for Linux, you can manually edit the configuration to transform a Mainnet node in a Testnet node.

Connect the self-installing node to the Testnet

As root or sudo user stop the node

systemctl stop quadrans-node

Substitute the gqdc binary with the latest test version for your architecture:

wget -O /usr/local/bin/gqdc
chmod +x /usr/local/bin/gqdc

Go to the quadrans home directory and change the configuration file:

cd /home/quadrans
vim environment

Disable the NODE_LISTED option i enabled:

export NODE_LISTED=false

Save and edit the Quadrans Node launcher.


Append the --testnet parameter in the last line of the file:

eval "/usr/local/bin/gqdc --testnet ${MINER_OPTS} ${STATS_OPTS}"

Or like this to enable RPC connection and API:

eval "/usr/local/bin/gqdc --testnet --rpc --rpcapi \"eth,net,web3,personal\" --rpccorsdomain \"*\" --rpcaddr \"IP_ADDRESS\" ${MINER_OPTS} ${STATS_OPTS}"

Save and restart the node.

systemctl restart quadrans-node

Manually launch the latest Test binary

Download the latest test version of the gqdc binary, based on your arcitecture from here:

For example for x86-64 version substitute the current Quadrans node binary with the test version:

wget -O /usr/local/bin/gqdc
chmod +x /usr/local/bin/gqdc

Execute the node to connect to the testnet:

/usr/local/bin/gqdc --testnet

Or like this to enable RPC connection and API:

/usr/local/bin/gqdc --testnet --rpc --rpcapi "eth,net,web3,personal" --rpccorsdomain "*" --rpcaddr "IP_ADDRESS"

Paths and folders

Once your node is configured for running in testnet, all working files are moved one level under the testnet folder

cd /home/quadrans/.quadrans/testnet

In this folder you will find:

ls -al
total 16
drwx------ 4 quadrans quadrans 4096 Oct 13 21:04 .
drwxr-xr-x 6 quadrans quadrans 4096 Aug 6 12:57 ..
srw------- 1 quadrans quadrans 0 Oct 13 21:04 gqdc.ipc
drwx------ 4 quadrans quadrans 4096 Oct 14 15:21 gqdc
drwx------ 2 quadrans quadrans 4096 Jul 26 14:11 keystore

Note that you’ll find the gqdc.ipc socket for rpc commands, a keystore folder for available the json accounts and wallets, the gqdc folder with chaindata and nodes info.

Check the node

You can check che node status using the same commands used for the main-net node, of course there will be differences and small changes.

If you run into any issue please check the troubleshooting session before contacting support


You might want to run the following commands to speed-up the connections to other testnet nodes


net.peerCount eth.syncing


In order to run your smart contracts and make some transactions you need to have testnet coin. Get them for free at the following address. You need to have a working wallet and address to claim your coins. You can get up to 1 coin per day.