Setup your Server

The Q Node is required to run on a server or a (virtual) machine. One possibility is to use a local machine, alternatively you can use a cloud instance on AWS for example. A good external tutorial on how to get started with Ethereum on AWS can be found here Also, you should open the custom port range 30300-30400 to connect to nodes from outside and 8000-8999 to run an RPC and WSS endpoint. Any other machine will work as well if it meets the following requirements:

  • Linux machine with SSH access;
  • Installed applications: docker, docker-compose, git (optional).

Guide how to install docker and docker-compose could be found by the links.

Hardware Requirments

Full Node Validator Node Root Node
Disk Min. 85 GB free disk space
Rec. 160 GB free disk space		 Min. 35 GB free disk space
Rec. 50 GB free disk space		 Min. 35 GB free disk space
Rec. 50 GB free disk space
Memory Min. 6 GB RAM
Rec. 8 GB RAM		 Min. 4 GB RAM
Rec. 6 GB RAM		 Min. 4 GB RAM
Rec. 6 GB RAM
CPU Min. 1(v) Core(x86)
Rec. 2(v) Cores(x86)		 Min. 1(v) Core(x86)
Rec. 2(v) Cores(x86)		 Min. 1(v) Core(x86)
Rec. 2(v) Cores(x86)
Bandwidth 24Mbps+ 24Mbps+ 24Mbps+

Check your setup

Open the terminal and go to the directory with the node you will run (testnet-public-tools/testnet-fullnode or testnet-rootnode or testnet-validator):

Linux

If you use Graphical User Interface(GUI), open terminal

  1. Press CTRL + ALT + T to open the terminal
  2. Or open Show Application in the Dash Bar & find out Terminal Application.
  3. Go to directory with command:
cd "path/to/testnet-public-tools/testnet-fullnode" # or testnet-rootnode, testnet-validator
Windows

Open PowerShell

  1. Press Windows+R to open the "Run" tool
  2. Type "powershell" and press Enter to open terminal
  3. Go to directory with command:
Set-Location -Path "testnet-public-tools\testnet-fullnode" # or testnet-rootnode, testnet-validator

If you work with cmd instead of PowerShell, use command:

cd /d "YOUR_DISK:\testnet-public-tools\testnet-fullnode" # or testnet-rootnode, testnet-validator
MacOS

Open Terminal on Mac

  1. Click the Launchpad icon in the Dock, type Terminal in the search field, then click Terminal.
  2. In the Finder, open the /Applications/Utilities folder, then double-click Terminal.
  3. Go to directory with command:
cd "path/to/testnet-public-tools/testnet-fullnode" # or testnet-rootnode, testnet-validator


Check that your node has access to outside:

docker-compose run --rm --entrypoint "ping 8.8.8.8" testnet-fullnode

Expected result:

Creating miner1_node_run ... done
PING 8.8.8.8 (8.8.8.8): 56 data bytes
64 bytes from 8.8.8.8: seq=0 <...>
64 bytes from 8.8.8.8: seq=1 <...>
64 bytes from 8.8.8.8: seq=2 <...>
64 bytes from 8.8.8.8: seq=3 <...>

Press Ctrl+C to stop.

Possible errors:

1. Error: Permission denied 
   Solution: to fix this run docker command with sudo or update docker permissions by sudo usermod -aG docker $USER
2. Error: Can't find a suitable configuration file in this directory or any parent
   Solution: switch to the directory that contains your docker-compose file, e.g. cd testnet-public-tools/testnet-fullnode

Now you are ready to setup your node. Detailed guide you may find here for fullnode, rootnode, validator.