Skip to main content

Set up a Node

Learn how to set up a node for the Babylon system.


This guide requires having Babylon installed on a Linux System. The instructions can be found on the Installation page The version to install is specified at the bbn-test-3 network info page.

0. System Requirements

This system spec has been tested by validators and found to be comfortable:

  • Quad Core or larger AMD or Intel (amd64) CPU
  • 32GB RAM
  • 1TB NVMe Storage
  • 100MBps bidirectional internet connection

You can run Babylon on lower-spec hardware for each component, but you may find that it is not highly performant or prone to crashing.

1. Initialize the Node Directory

First, initialize a node configuration directory under ~/.babylond. The $NODENAME variable specifies the name you aim to give your node.

babylond init $NODENAME --chain-id bbn-test-3

Then, retrieve the genesis file and place it in the node directory:

tar -xjf genesis.tar.bz2 && rm genesis.tar.bz2
mv genesis.json ~/.babylond/config/genesis.json

2. Add Peers and Modify Configuration

Edit the configuration file at ~/.babylond/config/config.toml and modify the seeds and persistent_peers attributes to contain appropriate seeds and peers of your choice. The full list of Babylon approved seeds and peers can be found under the bbn-test-3 network info page.

Edit the configuration file at ~/.babylond/config/app.toml and modify the btc-network attribute to contain the appropriate BTC network parameters as below and iavl-cache-size=0 to handle caching issues.

iavl-cache-size = 0

network = "signet"

On the same file, you can also modify the minimum-gas-prices attribute and set it to a value of your choosing. For example,

minimum-gas-prices = "0.00001ubbn"

3. Setup Cosmovisor

To install the latest version of Cosmovisor

go install

Create the necessary directories

mkdir -p ~/.babylond
mkdir -p ~/.babylond/cosmovisor
mkdir -p ~/.babylond/cosmovisor/genesis
mkdir -p ~/.babylond/cosmovisor/genesis/bin
mkdir -p ~/.babylond/cosmovisor/upgrades

Copy the babylond binary into the cosmovisor/genesis folder

cp $GOPATH/bin/babylond ~/.babylond/cosmovisor/genesis/bin/babylond

Setup a cosmovisor service:

sudo tee /etc/systemd/system/babylond.service > /dev/null <<EOF
Description=Babylon daemon

ExecStart=$(which cosmovisor) run start --x-crisis-skip-assert-invariants



4. Start the Node

sudo -S systemctl daemon-reload
sudo -S systemctl enable babylond
sudo -S systemctl start babylond

You can check the status of the node by running

systemctl status babylond