Skip to main content

Setting Up a Full Node

Learn how to set up the full 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-2 network info page.

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-2

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-2 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.

network = "mainnet"

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