Skip to main content

Install your RPC node

Network details

Here are the coordinates to the Arthera Mainnet

Running a RPC node

1. Get a Linux machine that meets the requirements

2. Install Docker

See the Docker Installation Guide

3. Pull the latest Arthera node image

docker pull arthera/arthera-node:1.2.1-rc.3

4. Create a folder to hold your Arthera node data

mkdir $HOME/arthera

5. Generate your node key

Run the command below to generate your unique node key:

docker run -it -v $HOME/arthera:/data arthera/arthera-node:1.2.1-rc.3 p2p genkey /data/node.key

Check to see if the key was generated successfully by running:

docker run -it -v $HOME/arthera:/data arthera/arthera-node:1.2.1-rc.3 p2p enodeurl /data/node.key

You should see an output similar to the one below:

enode://f2927b8b1bc1b05997acf60f713cda3c776300cdac52b80d8dbfb2b434ef0e7283f8d3ca891d832bab3927b03c52593e575d48d9916804af5bf66a75b5b1288a@127.0.0.1:6534

The output above is your node's enode URL.

6. Download the latest Mainnet genesis file

Run the command below to download the mainnet.g genesis file:

curl -o $HOME/arthera/mainnet.g https://s3.eu-central-1.amazonaws.com/release.arthera-net/epoch8131.g

7. Test your node

Replace the following variables and run the command below to start your node:

  • YOUR_PUBLIC_IP with your actual Public IP address.
docker pull arthera/arthera-node:1.2.1-rc.3
docker run --name arthera-rpc --network host -v $HOME/arthera:/data arthera/arthera-node:1.2.1-rc.3 \
--port 6533 \
--genesis /data/mainnet.g --genesis.allowUnknown \
--syncmode full \
--nodekey /data/node.key \
--verbosity 4 \
--cache 4000 \
--nat extip:YOUR_PUBLIC_IP

Check the output to have the following info:

INFO [12-25|06:00:50.553] Applying genesis state
INFO [12-25|06:00:50.553] - Reading epochs
INFO [12-25|06:00:50.554] - Reading blocks
INFO [12-25|06:00:50.556] - Reading EVM data
INFO [12-25|06:00:50.815] Applied genesis state name=main id=10242 genesis=0x993417afae15968aa185376537e2c633844b5e624444812b64e0241a3289d8be
INFO [12-25|06:00:50.928] Bootnode url=enode://c4138ac86c0cd7607231601afeb24d2d0b7aaf4c8e1de28978aab6fdbca1af2ec41307b33529e64da72b9e592782840aa1552bda5b1f700eefbdba2a662c4ecc@51.91.11.86:6533
INFO [12-25|06:00:50.928] Bootnode url=enode://91a72a01ba3eb7994c681d2e0212a8239d51fffe9dfdb38af373af2cb9612bf1f2f9514fea1b099a2d1e2bb83afa9c4487af7c7f05bcb5f0c6c63f8f757c7fcd@51.83.129.213:6533
INFO [12-25|06:00:50.928] Bootnode url=enode://c3c05932654c6a92a8f544857491073f96715fa394476edee07931bf4da00d76eeb1b256d0a68d0404a8b37e8dec7e038c18f1a4cdbde0da91ef45d04c243de1@57.128.172.20:6533
INFO [12-25|06:00:50.928] Bootnode url=enode://0ccae9dd3d8f6033929c9cf8371c4dd96f27c602e2cf9b363196a22557f8f36ca02b6ee64d20d230cb6b60d4a473066f9a4e6b0551d6ca67c797250c9bb3db20@217.182.60.41:6533
INFO [12-25|06:00:50.929] Bootnode url=enode://946ec02182a11adb2c93851303ca8c6a6ef5041d84e7f695f3dd6a574f1891b879c5bde1c19cafa1ad91a9057e7d6830b8def76dede45bda350a9deb4e0c152c@51.195.103.104:6533
....
INFO [08-12|05:23:22.805] New block ....
INFO [08-12|05:23:22.805] New block ....

If you get messages like New block it means your node is syncing and working properly.

You can now stop the node with Ctrl+C, clean the output folder with rm -rf $HOME/arthera/arthera-node $HOME/arthera/chaindata and remove the docker container with docker container rm arthera-rpc and move to the next step.

8. Run your node

Replace the following variables and run the command below to start your node:

  • YOUR_PUBLIC_IP with your actual Public IP address.
docker container rm arthera-rpc # remove any existing containers just to be sure
docker pull arthera/arthera-node:1.2.1-rc.3
docker run -d --restart unless-stopped --name arthera-rpc --network host -v $HOME/arthera:/data arthera/arthera-node:1.2.1-rc.3 \
--port 6533 \
--genesis /data/mainnet.g --genesis.allowUnknown \
--syncmode full \
--gcmode full \
--nodekey /data/node.key \
--metrics --metrics.addr 127.0.0.1 \
--verbosity 3 \
--cache 4000 \
--nat extip:YOUR_PUBLIC_IP

Check the node was started with docker ps:

CONTAINER ID   IMAGE                                   COMMAND                  CREATED         STATUS        PORTS     NAMES
d6ac0f5fdf14 arthera/arthera-node:1.2.1-rc.3 "arthera-node --data…" 2 seconds ago Up 1 second arthera-rpc

and check the logs of the container with docker logs -f arthera-rpc. You should see the following output:

INFO [08-12|05:57:39.972] New block                                ....
INFO [08-12|05:57:39.972] New block ....
INFO [08-12|05:57:39.972] New block ....
INFO [08-12|05:57:39.973] New block ....
INFO [08-12|05:57:39.973] New block ....
INFO [08-12|05:57:39.973] New block ....

Troubleshooting

1. Node is not syncing

The most common problems are firewalls and incorrectly provided external IP address.

2. Cleanup node data and restart node

  1. Stop the doocker container with docker container stop arthera-rpc
  2. Remove the database with rm -rf $HOME/arthera/arthera-node $HOME/arthera/chaindata
  3. Start the docker container with docker container start arthera-rpc

3. Database is corrupted

See Cleanup node data and restart node