Skip to main content

Run a validator node

Using AWS Image

Please replace the port according to the network. Below is the table mentioning ports of each network.


A Newrl node can be instantly spawned using the pre-built Newrl Image on AWS. Please note that for testnet image name is : Newrl Testnet Node - Ubuntu. At the launch time, the only configuration that needs to be specified is the security group to allow incoming connections on ports, refer table above on which port to open.

  1. In your aws console instances section click Launch Instance. (Change region to N.Virginia or Ohio as image is currently available in those)
  2. In the launch instance page, Under application and OS images section click Browse more AMIs
  3. In search bar, type in newrl testnet node.
  4. Under community AMI section, there should be an image under the name Newrl Testnet Node - Ubuntu. Select the image AWSNewrl
  5. Under network setting, make sure ssh, http, https traffic radio box is checked.
  6. Launch the instance.
  7. Once the instance is launched, Go to the instance page, under security tab click security group. Then add an inbound rule with port 8421 open from any source.

Add Node wallet to chain

Once the node is live, it's generated wallet key can be obtained by running the below command.

cd newrl
python3 scripts/


The node's wallet need to be added on the chain with the help of a custodian or as a linked wallet from Newrl wallet app.You can log into the wallet with a password specific to your machine/mobile. Inside, you can load your wallet from the node as obtained above (use only the json mentioned after β€œwallet” in the .auth.json file).

You can get your node’s public info from the URL /get-node-info. Example: If node’s public IP is, the url will be

From source code


  1. A computer accessible outside with port open for incoming.
    1. To start a node on AWS, launch an EC2 instance from instructions here. Make sure to make port 8456 open to public when configuring the security group.
    2. To start a node on Digital ocean droplet, instructions here
  2. Git installed. Steps here
  3. Python3.7+ installed. This is preinstalled on most common linux distributions. On ubuntu the steps will be sudo apt update && sudo apt install python3.10-venv
  4. Pip and python3 venv installed. Installation steps available here


Note: Below are sample commands for testnet. Replace the keyword 'testnet' with desired network name if needed.

git clone
cd newrl
scripts/ testnet

Start the node

screen -S newrl
scripts/ testnet

Screen session is used to let the node run in background when terminal is closed.

Import existing wallet

python3 scripts/ 
Enter environment[mainnet/testnet/devnet]: mainnet

Paste the existing wallet.

Note: The port 8456 for mainnet and 8421 if testnet should be publicly accessible on the instance. On AWS, this can be done by opening inbound port in the security group. For local installations, the router need to be configured to bypass symmetric NAT for the port 8456 for mainnet and 8421 for testnet.

Update the Node software

Nodes created using AWS image

Nodes created using AWS image can be update by mearely rebooting the instance from AWS console.

Nodes created from source

Follow the steps to update nodes created from source

  1. Login to screen session and stop the process by pressing Ctrl + C. Sometimes the process need to be force killed by running pkill -9 python outside of screen
  2. cd newrl
    scripts/ mainnet
    scripts/ mainnet --fullnode

Re-install a node

To re-install chain data on a node on a node with issues, follow the instructions below

Running no screen session

Stop newrl node

cd newrl/data_mainnet
rm newrl.db
scripts/ mainnet

Running from AWS image

sudo service newrl stop # Ctrl+C if not stopping in few seconds
cd newrl/data_mainnet
sudo rm newrl.db
sudo service newrl start