Cover photo

Nibiru Node Installation Guide

Minimum hardware requirements

  • CPU: 4 cores

  • Memory: 16 GB RAM

  • Storage: 1 TB SSD

Update the system

sudo apt update && sudo apt upgrade --yes

Install nibid

Option 1: Use this version if you plan to sync from genesis block; you will need to swap it to the current one at the upgrade height (either manually or with Cosmovisor)

curl -s https://get.nibiru.fi/@v1.0.0! | bash

Option 2: Use this version if you plan to use state-sync or data snapshot

curl -s https://get.nibiru.fi/@v1.3.0-rc1! | bash

Init the Chain

Init the chain

sudo apt update && sudo apt upgrade --yes

Copy the genesis file to the $HOME/.nibid/config folder.

You can get genesis from our networks endpoint with:

NETWORK=nibiru-testnet-1
curl -s https://networks.testnet.nibiru.fi/$NETWORK/genesis > $HOME/.nibid/config/genesis.json

Or you can download it from the Tendermint RPC endpoint.

curl -s https://rpc.testnet-1.nibiru.fi/genesis | jq -r .result.genesis > $HOME/.nibid/config/genesis.json

Update persistent peers list in the configuration file $HOME/.nibid/config/config.toml

NETWORK=nibiru-testnet-1
sed -i 's|\<persistent_peers\> =.*|persistent_peers = "'$(curl -s https://networks.testnet.nibiru.fi/$NETWORK/peers)'"|g' $HOME/.nibid/config/config.toml

Set minimum gas prices

sed -i 's/minimum-gas-prices =.*/minimum-gas-prices = "0.025unibi"/g' $HOME/.nibid/config/app.toml

[Optional Step] Configure one of the following options to catch up faster with the network

  • Option 1: Setup state-sync

    NETWORK=nibiru-testnet-1
config_file="$HOME/.nibid/config/config.toml"
sed -i "s|enable =.*|enable = true|g" "$config_file"
sed -i "s|rpc_servers =.*|rpc_servers = \"$(curl -s https://networks.testnet.nibiru.fi/$NETWORK/rpc_servers)\"|g" "$config_file"
sed -i "s|trust_height =.*|trust_height = \"$(curl -s https://networks.testnet.nibiru.fi/$NETWORK/trust_height)\"|g" "$config_file"
sed -i "s|trust_hash =.*|trust_hash = \"$(curl -s https://networks.testnet.nibiru.fi/$NETWORK/trust_hash)\"|g" "$config_file"

    Option 2: Download and extract data snapshot

    You can check available snapshots list for nibiru-testnet-1 to locate the snapshot with the date and type that you need

    curl -o nibiru-testnet-1-<timestamp>-<type>.tar.gz https://storage.googleapis.com/nibiru-testnet-1-snapshots/nibiru-testnet-1-<timestamp>-<type>.tar.gz
tar -zxvf nibiru-testnet-1-<timestamp>-<type>.tar.gz -C $HOME/.nibid/

Choose one of the options to start your node

Option 1: Systemd + Systemctl

After defining a service file for use with systemctl, you can execute:

sudo systemctl start nibiru

Option 2: Cosmovisor

After defining a service file for use with cosmovisor, you can execute:

sudo systemctl start cosmovisor-nibiru

Option 3: Without a daemon

nibid start

Request tokens from the Web Faucet for nibiru-testnet-1 if required

https://app.nibiru.fi/faucet

To create a local key pair, you may use the following command:

nibid keys add <key-name>