Setting up a Node

OriginTrail Decentralized Network is designed for scalability and enables anyone to run a node. Here, you can find all the resources and instructions for your setup. The network is currently in the test stage, enabling you to get familiar with the technology before the launch of the main network in Q3 2018.

VIDEO

Video 1: Quick setup

Video 1: Quick setup

Video 1: Quick setup

Requirements

Minimum requirements

2 GB RAM Memory and 5 GB HDD Free Disk Space

Install a Node

There are two ways to install ODN nodes: the express installation and manual installation. Both ways are explained below.

Express Installation via Docker - Recommended for non-advanced users

The fastest way to take ODN Testnet for a spin - install fast and edit settings afterwards. Docker is a free application that enables you to run software packages - you will get all the necessary commands in these instructions.

To install on Mac

1. Download and install Docker

Download the Docker app - community edition, stable version - and follow the installation instructions for your operating system.

Download

https://download.docker.com/mac/stable/Docker.dmg

Minimum requirements: Docker for Mac works on OS X El Capitan 10.11 and newer macOS releases.

Having troubles? Here are the instructions

https://docs.docker.com/docker-for-mac/install/

For older versions use Docker Toolbox

https://docs.docker.com/toolbox/overview/

2. Start docker

Find Docker among your installed programs and start it. Wait for the green indicator that Docker is running.

3. Open Terminal (Mac) and Finish the Installation Process

Once you’ve installed a stable version of Docker for your operating system, open the “Terminal” application on Mac (cmd+space to search for it or find it in the Applications/Utilities folder) and input the commands below.

1. Run the below command once (copy-paste it in terminal)

docker run -it --name=otnode -p 8900:8900 -p 5278:5278 -p 5279:5279 -p 4043:4043 -p 8529:8529 -p 3000:3000 -p 3010:3010 --mount source=otnode-vol,destination=/ot-node --mount source=arango-vol,destination=/var/lib/arangodb -e INSTALLATION=local origintrail/ot-node

Important: Be patient and do not close Terminal before the node is installed, it can take up to 20 minutes to install all the prerequisites (depending on your internet connection and computer hardware). This command will automatically install all necessary prerequisites needed to run a node on the ODN: Node.js, Arango.db, and Neo4j.

2. Once this process is complete, run the following command:

docker start otnode

This will run your node in the background, which means you can close the terminal window and it will continue operating. To check if it is running in Terminal, run the following command:

docker ps

This command will show if your node is running.

To stop a running node input, enter: ctrl + c

4. - Congratulations! You Have Just Installed an OriginTrail Node.

To interact easily with the node, go ahead and proceed with installing the UI for your node, called Houston. Note: When you install the node via Docker, a new Ethereum wallet address is automatically assigned to your node. You can change it at any time for your desired wallet via Houston.

Manually Install via Terminal

If you prefer to manually install each piece of software needed to run an ODN node, you can find detailed instructions in our technical documentation

OriginTrail Documentation

To install on Windows

1. Download and install Docker

Download the Docker app - community edition, stable version - and follow the installation instructions for your operating system.

Create Account and Download

https://store.docker.com/editions/community/docker-ce-desktop-windows

Minimum Requirements: Microsoft Windows 10 Professional or Enterprise 64-bit

Having trouble? Check out the instructions.

https://docs.docker.com/docker-for-windows/install/

For older versions use Docker Toolbox

https://docs.docker.com/toolbox/overview/

2. Start docker

Find Docker among your installed programs and start it. Wait for the green indicator that Docker is running.

3. Open Command Prompt (Windows) and finish Installation process

Once you’ve installed a stable version of Docker for your operating system, open the Command Prompt on Windows - search for it in the Start Menu - and input the commands below.

1. Run the command below once (copy-paste it into the command prompt):

docker run -it --name=otnode -p 8900:8900 -p 5278:5278 -p 5279:5279 -p 4043:4043 -p 8529:8529 -p 3000:3000 -p 3010:3010 --mount source=otnode-vol,destination=/ot-node --mount source=arango-vol,destination=/var/lib/arangodb -e INSTALLATION=local origintrail/ot-node

Important: Be patient and do not close Command Prompt before the node is installed, it can take up to 20 minutes to install all the prerequisites (depending on your internet connection and computer hardware). This command will automatically install all the necessary prerequisites needed to run a node on the ODN: Node.js, Arango.db, and Neo4j.

2. Once this process is complete, run the following command:

docker start otnode

This will run your node in the background, which means you can close the command prompt window and it will still be operating. To check if it is running in command prompt, run the following command:

docker ps

This command will show if your node is running.

To stop a running node input, enter: crtl + c

4 - Congratulations! You Have Just Installed an OriginTrail Node.

To easily interact with the node, go ahead and proceed with installing the UI for your node, called Houston. Note: When you install the node via Docker, a new Ethereum wallet address is automatically assigned to your node. You can change it at any time for your desired wallet via Houston.

Manually Install via Terminal

If you prefer to manually install each piece of software needed to run an ODN node, you can find detailed instructions on our GitHub

See more on GitHub

To install on Linux/Ubuntu

1. Download and install Docker

Download the Docker app - community edition, stable version - and follow the installation instructions for your operating system.

Download

https://docs.docker.com/engine/installation/linux/docker-ce/ubuntu/

Minimum requirements: 64-bit version of Bionic 18.04 (LTS), Artful 17.10. Xenial 16.04 (LTS), or Trusty 14.04 (LTS)

Having troubles? Here are the instructions

https://docs.docker.com/install/linux/docker-ce/ubuntu/

2. Start docker

Find Docker among your installed programs and start it. Wait for the green indicator that Docker is running.

3. Open Terminal (UBUNTU) and finish Installation process

Once you’ve installed a stable version of Docker for your operating system, open the “Terminal” application on Ubuntu and input the commands below.

1. Run the below command once (copy-paste it in terminal)

docker run -it -d --network host --name otnode --mount source=otnode-vol,destination=/ot-node origintrail/ot-node

Important: Be patient and do not close Terminal before the node is installed, it can take up to 20 minutes to install all the prerequisites (depending on your internet connection and computer hardware). This command will automatically install all necessary prerequisites needed to run a node on the ODN: Node.js, Arango.db, and Neo4j.

2. Once this process is complete, run the following command:

docker start otnode

This will run your node in the background, which means you can close the terminal window and it will still be operating. To check if it is running in terminal, run the following command:

docker ps

This command will show if your node is running.

To stop a running node input, enter: crtl + c

4 - Congratulations! You Have Just Installed an OriginTrail Node.

To interact easily with the node, go ahead and proceed with installing the UI for your node, called Houston. Note: When you install the node via Docker, a new Ethereum wallet address is automatically assigned to your node. You can change it at any time for your desired wallet via Houston.

Manually Install via Terminal

If you prefer to manually install each piece of software needed to run an ODN node, you can find detailed instructions on our GitHub

See more on GitHub

Step 2 - Install Houston app - User Interface for your Node

Houston is the visual user interface which makes operating a node easy for everyone

Tokens

With your beta node installation, you automatically receive some test TRAC tokens. If you need additional tokens, go to Faucet and follow the instructions.

Resources

Support Start here, if you experience problem with your installation

Discord Chat - Join our development community.