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:

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