This guide will cover setting up your non-validator node for the Oasis Network. This guide assumes some basic knowledge on the use of command line tools.

Prerequisites

Before following this guide, make sure you've followed the Prerequisites Guide and understand how to use the oasis-node binary.

Creating a Working Directory

We will be creating the following directory structure inside a chosen top-level /node (feel free to name your directories however you wish) directory:

• etc: This will store the node configuration and genesis file.

• data: This will store the data directory needed by the running oasis-node binary, including the complete blockchain state.

  The directory permissions should be rwx------.

To create the directory structure, use the following command:

mkdir -m700 -p /node/{etc,data}

Copying the Genesis File

The latest genesis file can be found in Network Parameters. You should download the latest genesis.json file and copy it to the /node/etc directory we just created.

Configuration

In order to configure the node create the /node/etc/config.yml file with the following content:

datadir: /node/data
​
log:
  level:
    default: info
    tendermint: info
    tendermint/context: error
  format: JSON
​
genesis:
  file: /node/etc/genesis.json
​
consensus:
  tendermint:
    p2p:
      # List of seed nodes to connect to.
      # NOTE: You can add additional seed nodes to this list if you want.
      seed:
        - "{{ seed_node_address }}"
​

Before using this configuration you should collect the following information to replace the variables present in the configuration file:

• {{ seed_node_address }}: The seed node address in the form ID@IP:port.

  You can find the current Oasis Seed Node address in the Network Parameters.

Starting the Oasis Node

You can start the node by running the following command:

oasis-node --config /node/etc/config.yml

Checking Node Status

To ensure that your node is properly connected with the network, you can run the following command after the node has started:

oasis-node control status -a unix:/node/data/internal.sock