Install Quadrans on Linux x86-64

Hardware requirements

Minimum system requirements:

  • Computer Desktop, Server or Virtual Machine

  • 1 Core 64bit CPU

  • 2 GB RAM

  • 50 GB storage

Suggested requirements:

  • Computer Desktop, Server or Virtual Machine

  • 2 Core 64bit CPU

  • 4 GB RAM

  • 100 GB storage

Self-installing from Quadrans repository on Debian/Ubuntu

Quadrans team recommends to use a supported Ubuntu LTS (18.04 or 20.04) or an updated Debian installation.

sudo wget -O /etc/apt/sources.list.d/quadrans.list
sudo wget -O -|sudo apt-key add -
sudo apt update
sudo apt install -y python quadrans-node

Follow the on screen instructions to install the node, enable miner options and create a Quadrans wallet address.

Manual installation for Linux (Intel 64bit or AMD 64bit)

This guide will recreate the same conditions as the go-quadrans binary automatically creates on Debian/Ubuntu.

The basic steps are :

  • Create a quadrans user with no password

  • Download the binary

  • Setup your configuration file (optional)

  • Create the go-quadrans launcher (optional)

  • Make the launcher a systemd service (optional)

Software requirements

Before downloading the go-quadrans verify in dialog, python3, systemd are already installed in your Linux Machine. For clock sync (mandatory) you can use indifferently ntp or systemd-timesyncd.

Create the quadrans user and download the latest binary

As root create a quadrans user with no password:

useradd -r -m quadrans

Download the latest binary:

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

Useful options

After downloading, run gqdc to connect your node to the Quadrans Network. Make sure to check the different options and commands with gqdc --help

To set your data directory:

gqdc -datadir datadir_path

To show your node in the Quadrans Network Status page:

gqdc --ethstats "Your Node Name"

To create a new Quadrans wallet create a password inside a text file and execute the following command:

gqdc account new --password Your_Password_File.txt

To execute the node as a Miner:

gqdc --mine --unlock 0xYour_Wallet_Address --password Your_Password_File.txt

To connect to Quadrans Testnet (download the last test Quadrans node binary).

Set up the Quadrans node launcher (optional)

To create a go-quadrans launcher firstly create and edit a configuration file called environment.

Enviromnent variable like NODE_LISTED (options true or false) and NODE_NAME are required to be listed in the Quadrans Status page. Your node information will be publicly available.

If your node will be a Miner or a Masternode MINER_OPTIONS (options true or false) and MINER_WALLET with the MINER_PASSWORD are required.

To create your configuration simpy edit and type the following code as quadrans user:

cat > /home/quadrans/environment <<'EOF'
export NODE_LISTED=true
export NODE_NAME="Your node name"
export MINER_OPTIONS=false
export MINER_WALLET=0xYourQuadransWalletAddress
export MINER_PASSWORD=/path/to/wallet_password_file.txt

The next step is create a go-quadrans launcher:

cat > /home/quadrans/ <<'EOF'
source /home/quadrans/environment


if [ "${MINER_OPTIONS}" = "true" ]; then
	MINER_OPTS="--mine --unlock ${MINER_WALLET} --password ${MINER_PASSWORD}"

if [ $(grep -c "NODE_LISTED=true" /home/quadrans/environment ) -eq 1 ]; then
	STATS_OPTS=$(printf "%sethstats \"%s\":\"QuadransStatsNetwork\"" "--" "${NODE_NAME}")

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

Make the launcher executable:

chmod +x /home/quadrans/


Set up the Quadrans node as systemd service (optional)

To make your node a systemd service and type the following code as root:

cat > /etc/systemd/system/quadrans-node.service <<'EOF'
Description=Quadrans Node Service



Enable and start the service

To launch the service for the first time and start automatically on boot:

systemctl start quadrans-node
systemctl enable quadrans-node

To check your node status:

systemctl status quadrans-node


journalctl -f | grep Quadrans

Enable your node for mining

Go to Mining and Reward chapter of this Wiki.

Create a Quadrans Node updater script (optional)

Quadrans Node Update Installer for x86-64 is bash script that check Internet connection, suspend the Quadrans Node Service, download the new version of the gqdc binary and relaunch the service at the end of the process.

Connect the node to Testnet

Please read the How to setup your node for testnet documentation.


You can move from Testnet to Mainnet at any time but you can’t connect to the two networks at the same time.