Run a Seed Node

This guide will cover setting up a seed 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:
1
mkdir -m700 -p /node/{etc,data}
Copied!
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
This will configure the given node to only act as a seed node.
In order to configure the node create the /node/etc/config.yml file with the following content:
1
datadir: /node/data
2
​
3
log:
4
  level:
5
    default: info
6
    tendermint: info
7
    tendermint/context: error
8
  format: JSON
9
​
10
genesis:
11
  file: /node/etc/genesis.json
12
​
13
consensus:
14
  tendermint:
15
    mode: seed
Copied!
Starting the Oasis Node
You can start the node by running the following command:
1
oasis-node --config /node/etc/config.yml
Copied!
Seed node address
To get the seed node Tendermint identity, run the following command:
1
oasis-node identity tendermint show-node-address --datadir /node/data/
Copied!
Share seed node address
Nodes can now use your seed node by specifying it via a configuration flag:
1
--consensus.tendermint.p2p.seed <TENDERMINT_ADDRESS>@<EXTERNAL_IP>:26656
Copied!

Run a Non-validator Node

Run a ParaTime Node

Last modified 8mo ago

Copy link

Contents

Prerequisites

Creating a Working Directory

Copying the Genesis File

Configuration

Starting the Oasis Node

Seed node address

Share seed node address