OriginTrail
Search…
Docker setup
Docker setup manual
Below is a step-by-step guide for a docker based DKGv6 setup.

Prerequisites

  • A dedicated 4GB RAM/2CPUs/ 50GB HDD Instance (minimum hardware requirements)
  • Docker Engine and Docker-Compose installed

Install docker.

For installation on Ubuntu based system, follow the official installation manual below:
Install Docker Engine on Ubuntu
Docker Documentation
Docker installation on for Ubuntu
For installation on a Debian based system, follow the official installation manual via link below:
Install Docker Engine on Debian
Docker Documentation
Docker installation on Debian
For installation on a CentOS based system, follow the official documentation via link below:
Install Docker Engine on CentOS
Docker Documentation
Docker installation on CentOS
For installation on a Windows based system, follow the official WSL installation documentation via link below:
Install WSL
docsmsft
WSL installation on Windows OS
To setup DKGv6 on Windows based system, you need to install your preferred linux subsystem on windows. After installation login into the Linux Subsystem and proceed to install docker-engine & docker-compose.

Setup the firewall

In order for DKGv6 to communicate and send telemetry metrics on the network, you need to open ports below through your firewall system.
For Linux based systems run:
1
sudo ufw allow 8900 && ufw allow 9000
Copied!

Install Docker-Compose

With docker installed on the system, you can download and install Docker Compose. Follow the official docker-compose installation documentation for your respective OS via link below:
Install Docker Compose
Docker Documentation
Docker-compose installation

Setup and Clone Code Repo

After installation and configuration of docker with docker-compose, proceed and clone OT-Node Git Repo on to your system.
1
cd ~
2
git clone -b v6/release/testnet https://github.com/OriginTrail/ot-node.git
Copied!
Optional: Create certs folder at home directory
You need to set up Certificates directory for OT-Node.
1
sudo mkdir ~/certs
Copied!

Setup configuration file

Create a configuration file in your current directory with the appropriate Public & Private keys.
1
sudo nano ~/ot-node/.origintrail_noderc
Copied!
​
If you wish to run your node with GraphDB, make sure that your configuration file has the correct parameters set under the "graphDatabase" section as shown in the example below:
1
{
2
"blockchain":[
3
{
4
"blockchainTitle": "Polygon",
5
"networkId": "polygon::testnet",
6
"rpcEndpoints": ["https://rpc-mumbai.maticvigil.com/"],
7
"publicKey": "...",
8
"privateKey": "..."
9
}
10
],
11
"graphDatabase": {
12
"username": "admin",
13
"password": ""
14
},
15
"logLevel": "trace",
16
"rpcPort": 8900,
17
"network": {
18
},
19
"ipWhitelist": [
20
"127.0.0.1"
21
]
22
}
Copied!
​
If you wish to run your node with BlazeGraph, make sure that your configuration file has the correct parameters set under the "graphDatabase" section as shown in the example below:
1
{
2
"blockchain":[
3
{
4
"blockchainTitle": "Polygon",
5
"networkId": "polygon::testnet",
6
"rpcEndpoints": ["https://rpc-mumbai.maticvigil.com/"],
7
"publicKey": "...",
8
"privateKey": "..."
9
}
10
],
11
"graphDatabase": {
12
"implementation": "Blazegraph",
13
"url": "http://localhost:9999/blazegraph",
14
"username": "admin",
15
"password": ""
16
},
17
"logLevel": "trace",
18
"rpcPort": 8900,
19
"network": {
20
},
21
"ipWhitelist": [
22
"127.0.0.1"
23
]
24
}
Copied!
Additional information on the configuration file and the parameters can be found here.
To obtain the IP address of the Linux Subsytem on Windows follow the steps below:
  • Obtain the IP address of your host machine by running this command from your Windows Linux distribution: cat /etc/resolv.conf
  • Copy the IP address following the term: nameserver.
  • Whitelist the IP address in .origintrail_noderc
  • To obtain the DKGv6 node IP address run command from WSL server (ip -4 addr show eth0) and access the node API with the return IP address.

Ubuntu based image build

From your git cloned directory, run the following to build and start Ubuntu based docker container.
1
docker-compose -f docker/docker-compose-ubuntu.yaml up
Copied!
Always run docker-compose command from the cloned "ot-node" directory, so that docker-compose can mount .origintrail_noderc file
​

Ubuntu based image build

From your git cloned directory, run the following to build and start Ubuntu based docker container with GraphDB:
1
docker-compose -f docker/docker-compose-ubuntu-graphdb.yaml up --detach
Copied!
or if you wish to build and start Ubuntu based docker container with BlazeGraph use:
1
docker-compose -f docker/docker-compose-ubuntu-blazegraph.yaml up --detach
Copied!
​

Debian based image build

From your git cloned directory, run the following to build and start Debian based docker container with GraphDB:
1
docker-compose -f docker/docker-compose-debian-graphdb.yaml up --detach
Copied!
or if you wish to build and start Debian based docker container with BlazeGraph use:
1
docker-compose -f docker/docker-compose-debian-blazegraph.yaml up --detach
Copied!
​

Alpine based image build:

From your git cloned directory, run the following to build and start Alpine based docker container with GraphDB:
1
docker-compose -f docker/docker-compose-alpine-graphdb.yaml up --detach
Copied!
or if you wish to build and start Alpine based docker container with BlazeGraph use:
1
docker-compose -f docker/docker-compose-alpine-blazegraph.yaml up --detach
Copied!
  1. 1.
    docker-compose command will first pull and then start three containers (ot-node, mysql, graphdb).
  2. 2.
    --detach will start docker containers as a background process
  3. 3.
    use "docker logs -f ot-node" command in order to see the node logs and confirm that your node is successfully started
​
Congratulations. Welcome to v6 beta!