Loading...

General intro

This guide helps you set up a Berachain node - a machine that syncs the entire blockchain, allowing you to interact with the network or become a validator in the future.


Install Required Packages

These tools are essential for downloading, compiling, and running your node. They’re standard packages used in almost every node setup. 
sudo apt update && sudo apt upgrade -y
sudo apt install curl git wget htop tmux build-essential jq make lz4 gcc unzip -y

Install Go

Go (or Golang) is the programming language Berachain is built with. We need it to build the node binary beacond from source code. 
cd $HOME
sudo rm -rf /usr/local/go
wget https://go.dev/dl/go1.23.6.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.23.6.linux-amd64.tar.gz
echo "export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin" >> $HOME/.bash_profile
source ~/.bash_profile
[ ! -d ~/go/bin ] && mkdir -p ~/go/bin
go version
which go
rm -rf go1.23.6.linux-amd64.tar.gz

Download and build binary

Option 1: Build from source 
cd $HOME
rm -rf beacon-kit
git clone https://github.com/berachain/beacon-kit
cd beacon-kit
git checkout v1.1.4
make install
beacond version
which beacond
Option 2: Download Prebuilt Binary 
wget -O beacond https://snapshots.tienthuattoan.com/mainnet/berachain/beacond && mv beacond $HOME/go/bin
beacond version
which beacond

Initialize the node

Set node configuration 
beacond config chain-id mainnet-beacon-80094
Initialize the node 
beacond init you-node-name --chain-id mainnet-beacon-80094

Download Genesis & Addrbook Files

genesis.json defines the starting state of the chain. addrbook.json helps your node discover peers. 
curl -Ls https://snapshots.tienthuattoan.com/mainnet/berachain/genesis.json > $HOME/.beacond/config/genesis.json
curl -Ls https://snapshots.tienthuattoan.com/mainnet/berachain/addrbook.json > $HOME/.beacond/config/addrbook.json

Add seed

Seed nodes help your node find and connect to the network. It’s like a bootstrap contact list.

sed -i -e "s|^seeds *=.*|seeds = \"a2cb1a3d1c0a5d86dbcbcff8186c0bc4d9bfecfa@berachain-rpc.tienthuattoan.com:26656\"|" $HOME/.beacond/config/config.toml

Set minimum gas price

This tells your node to accept transactions with at least 0bera gas price. Required for block creation. 
sed -i -e "s|^minimum-gas-prices *=.*|minimum-gas-prices = \"0bera\"|" $HOME/.beacond/config/app.toml

Pruning & Indexer Settings

Pruning saves disk space by deleting older data. Disabling indexer also reduces storage load. 

sed -i \
  -e 's|^pruning *=.*|pruning = "custom"|' \
  -e 's|^pruning-keep-recent *=.*|pruning-keep-recent = "100"|' \
  -e 's|^pruning-keep-every *=.*|pruning-keep-every = "0"|' \
  -e 's|^pruning-interval *=.*|pruning-interval = "10"|' \
  $HOME/.beacond/config/app.toml

sed -i 's/indexer = "kv"/indexer = "null"/g' $HOME/.beacond/config/config.toml

Download Snapshot

Instead of syncing the chain from scratch (which can take days), a snapshot lets your node start from a recent blockchain state and catch up quickly. 
wget -O berachain_latest.tar.lz4 https://snapshots.tienthuattoan.com/mainnet/berachain/berachain_latest.tar.lz4 && lz4 -c -d berachain_latest.tar.lz4 | tar -x -C $HOME/.beacond

Create service

This lets your node run in the background like a service and auto-restart if it crashes. 
sudo tee /etc/systemd/system/beacond.service > /dev/null << EOF
[Unit]
Description=Berachain node service
After=network-online.target
[Service]
User=$USER
ExecStart=$(which beacond) start
Restart=on-failure
RestartSec=5
LimitNOFILE=65535
[Install]
WantedBy=multi-user.target
EOF
Start the service and check the logs. This shows real-time logs to help you monitor your node’s sync progress and status. 
sudo systemctl daemon-reload
sudo systemctl enable beacond
sudo systemctl restart beacond
sudo journalctl -u beacond -f

Check If Your Node Is Synced

Run the following command to watch your node's sync status in real time: 
watch -n 1 "curl -s localhost:26657/status | jq"

You're fully synced when "catching_up": false, your node is fully synced with the network and ready to use.

{
  "latest_block_height": "1234567",
  "latest_block_time": "2025-04-06T14:23:00Z",
  "catching_up": false
}