Linux

Guide for running the Taraxa Node with Docker on Linux

These instructions are specific to Linux. Instructions are also available for Windows and Mac.

1. Install Docker

Open a terminal window and run the following commands to install Docker:

wget -O get-docker.sh https://get.docker.com 
sudo sh get-docker.sh
sudo apt install -y docker-compose
rm -f get-docker.sh

Install Docker

2. Download the Taraxa Scripts

cd ~/
wget https://github.com/Taraxa-project/taraxa-ops/archive/refs/heads/master.zip && unzip master.zip && rm -f master.zip

GitHub is blocked in some countries. If you can't run the previous command please refer to the GitHub is blocked document.

Download Scripts

3. Start the Taraxa Node

cd ~/taraxa-ops-master/taraxa_compose
sudo docker-compose up -d
sudo docker-compose logs -f

Start Node

The node will start after Docker pulls the latest Taraxa Node image.

Node Running

NOTE: You can press CTRL + C to stop displaying the logs

4. Update the Taraxa Node

From time to time we will release new versions of the node software. Try to keep it up to date using the following commands:

cd ~/taraxa-ops-master/taraxa_compose
wget -O docker-compose-new.yml https://raw.githubusercontent.com/Taraxa-project/taraxa-ops/master/taraxa_compose/docker-compose.yml && mv docker-compose-new.yml docker-compose.yml

GitHub is blocked in some countries. If you can't run the previous command please refer to the GitHub is blocked document.

sudo docker-compose down
sudo docker-compose pull
sudo docker-compose up -d
sudo docker-compose logs -f

During the testing period, we will also make changes on the protocol level and you will have to re-sync all the data. Don't worry, we will let you know. To remove the current data and do a full re-sync you have to run the following commands:

cd ~/taraxa-ops-master/taraxa_compose
sudo docker-compose down -v
sudo docker-compose pull
sudo docker-compose up -d
sudo docker-compose logs -f