How to Deploy an OKB Chain Node on Linux: Full Node Setup

How to Deploy an OKB Chain Node on Linux: Full Node Setup
How To Deploy An OKBC Node

Are you eager to deploy a node on the OKB Chain? Our step-by-step guide will walk you through the process of setting up your first OKB Chain node and everything you need to do this.

What is an OKB Chain Node?

OKB Chain is a blockchain project developed by OKX, a renowned cryptocurrency exchange. OKB is the native token of OKB Chain and OKX. OKB Chain nodes are like computers that help the network work properly. There are two types of nodes: validator nodes and RPC nodes.

  • Validator nodes are important because they make sure transactions are valid and keep the network secure. Only authorized nodes can be validators. You can see these nodes on OKLink Explorer.
  • RPC nodes are service providers that let developers interact with the OKB Chain. They provide access to the blockchain for external applications. OKB Chain has its own public RPC endpoint, but others can also run their RPC nodes.

Running a node has benefits like better performance and access to blockchain data. There are two types of networks: mainnet (for real transactions) and testnet (for testing).

OKB Chain Node Setup Requirements

Minimum Hardware Configuration

To operate an OKB Chain node effectively, you must meet the following minimum hardware configuration:

  • CPU: 3.5 GHz, 4-Core
  • System: x86_64
  • RAM: 32GB
  • Storage: 200GB SSD
  • Bandwidth: 100M

Recommended AWS instance type:

  • AWS r6i.2xlarge: 4 Cores, 32GB RAM, 3.5GHz CPU

Note: as the network grows, minimum storage requirements may change. For a robust full node, it's best to exceed the minimum hardware requirements. It's also advised to regularly check out Hardware Requirements for OKB Chain nodes.

System Recommendations


  • OKB Chain nodes use level db to store block data and state data.
  • Disks that are frequently read from require higher disk performance.


  • Using an ordinary cloud disk from Alibaba Cloud may lead to node synchronization lag.


  • Use Standard SSD for Alibaba Cloud and AWS machines to ensure smoother synchronization and optimal node performance.

Following these requirements and recommendations will enhance your OKB Chain node's reliability and responsiveness, contributing to the network's overall efficiency.

How to Deploy an OKBC Node on Linux: Full Node Setup

Whether you join the public testnet or create your own OKBC localnet, the first-and-foremost step is to install OKBC. OKBC setup guide is available on OKX developers docs.

Initialize the node

  • Start the node and generate the required configuration files:
okbchaind init <your_custom_moniker> --chain-id okbchaintest-195
NOTE: Only ASCII characters are allowed in monikers. If you use Unicode characters, your node will become unreachable.

You can edit this moniker later, in the ~/.okbchaind/config/config.toml file:

# A custom human readable name for this node
moniker = "<your_custom_moniker>"

To activate the anti-spam feature and decline incoming transactions with gas prices below the minimum, modify the  ~/.okbchaind/config/okbchaind.toml.

# This is a TOML config file.
# For more information, see

##### main base config options #####

# The minimum gas prices a validator is willing to accept for processing a
# transaction. A transaction's fees must meet the minimum of any denomination
# specified in this config (Our recommended quantity is  10^-9 okb).

minimum-gas-prices = ""

Your node is now initialized!

Genesis & Seeds

Copy the Genesis File

Go get the testnet's genesis.json and put it in okbchaind's config directory.

To double-check if the configuration is correct, use the command:

okbchaind start --chain-id okbchaintest-195

Add Seed Nodes

To enable your node to find peers, make sure to include reliable seed nodes in the $HOME/.okbchaind/config/config.toml.

You have the option to add seeds in the ~/.okbchaind/config/config.toml file:

# Comma separated list of seed nodes to connect to
seeds = "[email protected]:26656"

or add the seed node using flag when starting the node:


Get more details on seeds and peers here.

Start a New Node

  • To start a full node, use this command:
okbchaind start --chain-id okbchaintest-195
  • To check if the node runs smoothly or not, use this command:
okbchaincli status

JSON-RPC Endpoint

Upgrading Your Node

These instructions are for full nodes that have previously been running and want to upgrade to the latest testnet version.

Software Upgrade

Upgrade the software using the command:

git clone
cd okbchain
git fetch --all && git checkout dev
make install
# start your node with the new version
okbchaind start --chain-id okbchaintest-195
NOTE: If you encounter any problems at this stage, make sure to verify that you have the most recent stable version of GO installed.

Note that we are using the dev version as it includes the most recent stable release. For more information about each release, kindly refer to the OKBC release page.

Your full node has been successfully upgraded!

Join the Public Testnet With Docker

Run OKBC testnet fullnode with docker

  • Download the docker image
docker pull okbchain/fullnode-testnet:latest
  • Create the data directory

You can get the testnet snapshot from here and extract it into the ${DATA_DIR}.

Run docker container

# p2p.seeds help to connect to testnet
# rest.laddr expose rest service

docker run -d --name okbchain-testnet-fullnode -v ${DATA_DIR}:/root/.okbchaind/data/ -p 8545:8545 okbchain/fullnode-testnet:latest sh -c "okbchaind start --p2p.seeds=f0721bd46ff3a9f9186cfe208c344d11ff918cd6@ --rest.laddr=tcp://"

Notice: ${DATA_DIR} has to be an absolute path

View the running log

docker logs --tail 100 -f okbchain-testnet-fullnode

Stop and restart the fullnode

  • Stop
docker stop okbchain-testnet-fullnode
  • Restart
docker start okbchain-testnet-fullnode


You can use local RPC when docker reaches the latest block:http://localhost:8545

Our guide follows the relevant documentation available on the OKX domain. We encourage you to regularly check out OKX's node setup guide for the latest update.

Read more