Setup node on Docker

Make sure your system meets the minimum requirements before installing RSK nodes on it.

Install Docker Desktop Client

Docker Desktop provides an easy and fast way for running containerized applications on various of operating systems.

For Mac OSX and Windows:

• Download and install
• Start the Docker Desktop client
• Login with a Docker Hub free account

For Linux:

• Install Docker Engine Community
• Note that you will need to use sudo for all docker commands, by default. To avoid this additional steps are required.

Ensure that docker is running by running the following command - it should run without any errors.

docker ps

More information about Docker install here.

Install RskJ Using Docker

First of all, download the RSK a Dockerfile and supervisord.conf from artifacts repo.

Inside the artifacts repo, you can choose which type of node you are going to install:

• A node connected to the public RSK Mainnet: Dockerfile.MainNet
• A node connected to the public RSK Testnet: Dockerfile.TestNet
• A node connected to a private RegTest network: Dockerfile.RegTest

Install the node using Docker containers

Then build the container by running (depending on your node’s type):

• Mainnet

  docker build -t mainnet -f Dockerfile.MainNet .
  

• Testnet

  docker build -t testnet -f Dockerfile.TestNet .
  

• Regtest

  docker build -t regtest -f Dockerfile.RegTest .
  

When the build finishes, you have a container ready to run RSK.

To run the container, you should execute (depending on your node’s type):

• Mainnet

  docker run -d --name mainnet-node-01  -p 4444:4444 -p 5050:5050 mainnet
  

• Testnet

  docker run -d --name testnet-node-01  -p 4444:4444 -p 50505:50505 testnet
  

• Regtest

  docker run -d --name regtest-node-01  -p 4444:4444 -p 30305:30305 regtest
  

Video