Page cover image

Ojo

Installation Guide for Ojo Node

Setting up an Ojo node is a straightforward process that enables you to participate in the Ojo network, which is built on the Cosmos SDK. This guide will walk you through the installation steps with detailed explanations.

Prerequisites

Before you begin, ensure your system meets the following requirements:

Requirement
Minimum

Operating System

Ubuntu 20.04 or higher

RAM

8 GB

CPU

4 cores

Disk Space

100 GB SSD

Network

Stable internet access

Step 1: Update Your System

Open your terminal and run the following commands to update your package list and upgrade existing packages:

sudo apt update && sudo apt upgrade -y

Step 2: Install Required Dependencies

You will need to install Git and Go programming language. Execute the following commands:

sudo apt install git -y
wget https://golang.org/dl/go1.20.5.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.20.5.linux-amd64.tar.gz
echo "export PATH=\$PATH:/usr/local/go/bin" >> ~/.profile
source ~/.profile

Step 3: Clone the Ojo Repository

Clone the Ojo repository from GitHub to get the necessary files for installation:

git clone https://github.com/ojo-network/ojo.git
cd ojo

Step 4: Build the Ojo Node

Navigate to the Ojo directory and build the node:

make install

Step 5: Initialize the Node

After building the node, initialize it with a unique moniker (name):

ojod init <your_moniker>

Step 6: Configure the Node

Edit the configuration file to set your node parameters. Open the configuration file located in ~/.ojo/config/config.toml:

nano ~/.ojo/config/config.toml

Make sure to set the following parameters:

  • chain_id: Set this to the appropriate chain ID for Ojo.

  • seeds: Add seed nodes to help your node connect to the network.

Step 7: Download Genesis File

To synchronize your node with the network, download the genesis file:

curl -o ~/.ojo/config/genesis.json https://raw.githubusercontent.com/ojo-network/genesis/main/genesis.json

Step 8: Start the Node

Once everything is configured, you can start your Ojo node:

ojod start

Step 9: Monitor Node Activity

To monitor the logs and activity of your node, use the following command:

tail -f ~/.ojo/logs/ojod.log

Additional Configuration

  1. Set Up a Systemd Service: To ensure your node runs continuously, you can set it up as a systemd service. Create a new service file:

sudo nano /etc/systemd/system/ojo.service

Add the following content:

[Unit]
Description=Ojo Node
After=network-online.target

[Service]
User=$USER
ExecStart=$(which ojod) start
Restart=on-failure
LimitNOFILE=4096

[Install]
WantedBy=multi-user.target
  1. Enable and Start the Service:

sudo systemctl enable ojo
sudo systemctl start ojo

Last updated