Node Client

Last updated 18 days ago

Introduction

This is a QuickStart guide to running a RadixDLT Node on your computer primarily aimed for non-technical users. The following steps will be covered:

  1. Installing Docker

  2. Installing Docker Compose (Linux only)

  3. Creating a docker-compose.yml configuration file

  4. Launching your RadixDLT Node

Pre-requisites

Hardware

Your targeted node should have at least:

  • 2 CPU cores

  • 8 GB memory

  • 256 GB disk

The actual disk size requirement will grow over time as the ledger grows.

Software

You can run a RadixDLT node on any operative system that supports Docker and Docker Compose, including:

  • Linux

  • MacOS X

  • Windows 10

Forwarding Incoming Traffic to your Node

You can skip this if your node is directly connected to the internet (has a public IP address).

If you are behind a firewall/NAT (typically 192.168.*, 10.* IP address), then you need to forward traffic to your node including:

  1. Incoming Gossip traffic on TCP port 20000.

  2. Incoming Gossip traffic on UDP port 20000.

  3. Incoming HTTPS traffic on TCP port 443.

Furthermore, you need to make sure your DHCP server is assigning a static IP address to your node, otherwise forwarded traffic will fail if your node’s IP address changes later on.

These are rather straight forward changes that most consumer Routers support. Please refer to the user guide of your Router for how to do this.

These ports might change for Beta - please check back later.

Installing Docker

Please refer to the official installation guide for Docker CE.

Installing Docker Compose

Docker Compose is bundled with Docker CE for the Mac and Windows versions.

You only need to install Docker Compose separately if running on Linux.

Creating a docker-compose.yml configuration file

The RadixDLT software stack is composed of a set of specialised docker images, with different roles. The minimal (basic) radixdlt system contains the following two components (docker images):

  1. radixdlt.azurecr.io/radixdlt/radixdlt-core:latest-alpha

  2. radixdlt/radixdlt-nginx:latest-alpha

Your docker-compose.yml determines the software components you will run. In perticular the following is specified:

  1. One or more Docker images to download and start

  2. The configuration (see environment variables) for each Docker image

  3. Persistent data volumes - that survive restarts and upgrades.

Start with this docker compose file:

version: '3.2'
services:
core:
image: radixdlt.azurecr.io/radixdlt/radixdlt-core:latest-alpha
restart: unless-stopped
network_mode: "bridge"
ports:
- "20000:20000/tcp"
- "20000:20000/udp"
environment:
WIPE_LEDGER: "no"
WIPE_NODE_KEY: "no"
CORE_GOSSIP_PORT: 20000
CORE_NETWORK_SEEDS:
CORE_NETWORK_DISCOVERY_URLS: https://alphanet.radixdlt.com/node-finder
CORE_PARTITION_FRAGMENTS: 1
CORE_UNIVERSE: "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"
volumes:
- "core_ledger:/opt/radixdlt/RADIXDB"
- "core_config:/opt/radixdlt/etc"
logging:
options:
max-size: "10m"
max-file: "30"
nginx:
image: radixdlt/radixdlt-nginx:latest-alpha
restart: unless-stopped
network_mode: "bridge"
ports:
- "443:443"
environment:
WIPE_ADMIN_PASSWORD: "no"
volumes:
- "nginx_secrets:/etc/nginx/secrets"
logging:
options:
max-size: "1m"
max-file: "30"
volumes:
core_ledger:
core_config:
nginx_secrets:
  1. Create a directory on your computer for storing docker compose files (e.g. radixdlt).

  2. Use your favorite text editor to create the basic-node.yml.

  3. Copy-and-paste the content above.

You can also download the latest version of this file basic-node.yml.

Launching your Node

Open up Terminal (Mac/Linux) or CMD on Windows. Navigate to the directory that you put your docker-composer.yml file in. Launch the Docker containers with:

cd ~/radixdlt
docker-compose -p radixdlt -f basic-node.yml up -d

If successful, it should pull down and look something like this when completed:

Pulling core (radixdlt.azurecr.io/radixdlt/radixdlt-core:latest-alpha)...
latest-alpha: Pulling from radixdlt/radixdlt-core
...
Digest: sha256:d7f31770d1060d20ffd8f21365158937e893e4d3ce5ccdc089d1d11bbf26d4e0
Status: Downloaded newer image for radixdlt.azurecr.io/radixdlt/radixdlt-core:latest-alpha
Pulling nginx (radixdlt/radixdlt-nginx:latest-alpha)...
latest-alpha: Pulling from radixdlt/radixdlt-nginx
...
Digest: sha256:0f38c6706e2a2e6ff20e0167d266998dc4d2813e1b12ede644cfd97c9127161c
Status: Downloaded newer image for radixdlt/radixdlt-nginx:latest-alpha
Creating radixdlt_nginx_1 ... done
Creating radixdlt_core_1 ... done

Check that you have two (radixdlt_nginx_1 and radixdlt_core_1) Docker containers with:

docker ps

Make note and write down the admin password - its written in the radixdlt_nginx_1 container logs the first time it starts:

docker logs radixdlt_nginx_1

This password is used for accessing administrative APIs on your node. If you forget, you can re-generate this at any time by setting the WIPE_ADMIN_PASSWORD environment variable.

You can also check if the Node is up and running here: https://localhost/api/system

NOTE: Since it is a self-signed certificate browsers are expected to warn you that this link is unsafe - you can disregard this for Alpha/Beta.

If running correctly you should get a bunch of metrics - it should look something like this:

{"ledger":{"processed":0,"latency":{"path":0,"persist":0},"stored":3,"checksum":2193713224449319881,"processing":0,"faults":{"tears":0,"stitched":0},"storing":0},"agent":{"protocol":100,"name":"/Radix:/2300000","version":2300000},"hid":{"serializer":"EUID","value":"13115213306523712699347341883"},"period":0,"memory":{"total":122683392,"max":466092032,"free":61252608},"commitment":{"serializer":"HASH","value":"0000000000000000000000000000000000000000000000000000000000000000"},"serializer":-1833998801,"clock":0,"processors":4,"version":100,"shards":{"high":9223372036854775807,"low":-9223372036854775808},"port":20000,"messages":{"processed":0,"processing":0},"events":{"processed":27,"processing":0},"key":{"serializer":"BASE64","value":"AtadBccJwmoeY70gWLM0hQyTJtbhROrupp9A4/DHzXMa"}}

After around a minute or so, your new Node should also have found some Peers - to check it’s peer grouping, look here: https://localhost/api/network/peers

If it is working correctly, you should have around a full browser page of peer information that looks something like this:

{"serializer":"BASE64","value":"AtvDaWQgPRftFxpybWD/1Yyt3w5UPI510bp6+ruQ3+Sf"}},"host":
{"port":20000,"ip":"13.66.168.246"},"serializer":2451810,"version":100},
{"system":{"shards":{"high":6917529027641081855,"low":4611686018427387904},"agent":
{"protocol":100,"name":"/Radix:/2270000","version":2270000},"period":152913929,"port":20000,"commitment":
{"serializer":"HASH","value":"0000000000000000000000000000000000000000000000000000000000000000"},"serializer":-1833998801,"clock":114,"version":100,"key":

Congratulations, you are now successfully running a Radix Node!

Kitematic

This is optional, but if you are running your Node on a Mac or Windows computer you can download Kitematic to add a UI to your Docker container: If you want access to nice buttons and a live log view; this is definitely for you!

Kitematic by Docker

Node Configuration Options

Changing the configuration below in your docker compose file requires that your re-run docker compose:

docker-compose -p radixdlt -f basic-node.yml up -d

WIPE_ADMIN_PASSWORD

Setting this to yes and restarting the nginx service will wipe and regenerate the admin user’s password.

WIPE_LEDGER

Setting this to yes and restarting the core service will wipe the local ledger and re-sync it from other nodes in the RadixDLT network.

WIPE_NODE_KEY

Setting this to yes and restarting the core service will wipe the node.key file, which is your RadixDLT identity on the network. Hence, you will get a new identity and probably end up in a different shard.

CORE_GOSSIP_PORT

This is 20000 for the Alpha network and needs to match the port encoded in the CORE_UNIVERSE string.

CORE_NETWORK_SEEDS

Concrete IP address for discovering other nodes on the RadixDLT network.

Either CORE_NETWORK_SEEDS or CORE_NETWORK_DISCOVERY_URLS or both need to be set.

CORE_NETWORK_DISCOVERY_URLS

The URL to a simple web service, which returns an IP address to a random node on the RadixDLT network. This IP address will be used for discovering other nodes on the network.

Either CORE_NETWORK_DISCOVERY_URLS or CORE_NETWORK_SEEDS or both need to be set.

CORE_PARTITION_FRAGMENTS

Number of shards that the target network is partition in. For the Alpha network is partitioned into 1shards.

CORE_UNIVERSE

Universe identity and properties (such as gossip port). This string separates two RadixDLT networks from each other.

There are a bunch of frameworks for managing metrics. In the next guide, we extend the basic-node.yml to include the Prometheus service. Prometheus periodically collects metrics system, and application specific metrics and stores these in its local datastore.

Join the Radix Community