💾Node Installation

Bitsong Mainnet guide

EXPLORER

• Approximate hardware requirements:

Node Type	CPU	RAM	Storage
Mainnet	8	16GB	250GB

1) Auto_install script

source <(curl -s https://raw.githubusercontent.com/111STAVR111/props/refs/heads/main/Bitsong/bitsongd)

2) Manual installation

Preparing the server

sudo apt update && sudo apt upgrade -y
sudo apt install curl tar wget clang pkg-config libssl-dev jq build-essential bsdmainutils git make ncdu gcc git jq chrony liblz4-tool -y

GO 1.23.1

cd $HOME
VER="1.23.1"
wget "https://golang.org/dl/go$VER.linux-amd64.tar.gz"
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf "go$VER.linux-amd64.tar.gz"
rm "go$VER.linux-amd64.tar.gz"
[ ! -f ~/.bash_profile ] && touch ~/.bash_profile
echo "export PATH=$PATH:/usr/local/go/bin:~/go/bin" >> ~/.bash_profile
source $HOME/.bash_profile
[ ! -d ~/go/bin ] && mkdir -p ~/go/bin

Build 26.06.25

cd $HOME && mkdir $HOME/go/bin/
git clone https://github.com/bitsongofficial/go-bitsong/
cd go-bitsong
git checkout v0.23.0
make install

bitsongd version --long | grep -e version -e commit

• version: 0.23.0

• commit: f4c98e4ffe21a17524d26c2d018c8e4e526f50ab

Initiation

bitsongd init STAVR_guide --chain-id=bitsong-2b
bitsongd config chain-id bitsong-2b

Create/recover wallet

bitsongd keys add <walletname>
           OR
bitsongd keys add <walletname> --recover

Download Genesis

wget -O $HOME/.bitsongd/config/genesis.json "https://server-1.stavr.tech/Mainnet/Bitsong/genesis.json"

sha256sum $HOME/.bitsongd/config/genesis.json

• 53d3a4c628627bdc5d6c9d1016f973dfb3e0e93599be787d1759f4591d0129ac

Set up the minimum gas price and Peers/Seeds/Filter peers/MaxPeers

sed -i.bak -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0.01ubtsg\"/;" ~/.bitsongd/config/app.toml
external_address=$(wget -qO- eth0.me) 
sed -i.bak -e "s/^external_address *=.*/external_address = \"$external_address:26656\"/" $HOME/.bitsongd/config/config.toml
peers=""
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.bitsongd/config/config.toml
seeds=""
sed -i.bak -e "s/^seeds =.*/seeds = \"$seeds\"/" $HOME/.bitsongd/config/config.toml
sed -i 's/max_num_inbound_peers =.*/max_num_inbound_peers = 50/g' $HOME/.bitsongd/config/config.toml
sed -i 's/max_num_outbound_peers =.*/max_num_outbound_peers = 50/g' $HOME/.bitsongd/config/config.toml

Pruning (optional)

pruning="custom"
pruning_keep_recent="1000"
pruning_keep_every="0"
pruning_interval="10"
sed -i -e "s/^pruning *=.*/pruning = \"$pruning\"/" $HOME/.bitsongd/config/app.toml
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"$pruning_keep_recent\"/" $HOME/.bitsongd/config/app.toml
sed -i -e "s/^pruning-keep-every *=.*/pruning-keep-every = \"$pruning_keep_every\"/" $HOME/.bitsongd/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"$pruning_interval\"/" $HOME/.bitsongd/config/app.toml

Indexer (optional)

indexer="null" &&
sed -i -e "s/^indexer *=.*/indexer = \"$indexer\"/" $HOME/.bitsongd/config/config.toml

Download addrbook

wget -O $HOME/.bitsongd/config/addrbook.json "https://server-1.stavr.tech/Mainnet/Bitsong/addrbook.json"

Create a service file

sudo tee /etc/systemd/system/bitsongd.service > /dev/null <<EOF
[Unit]
Description=bitsong
After=network-online.target

[Service]
User=$USER
ExecStart=$(which bitsongd) start
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

StateSync Bitsong Mainnet

systemctl stop bitsongd
SNAP_RPC=https://bitsong.rpc.m.stavr.tech:443
cp $HOME/.bitsongd/data/priv_validator_state.json $HOME/.bitsongd/priv_validator_state.json.backup
LATEST_HEIGHT=$(curl -s $SNAP_RPC/block | jq -r .result.block.header.height); \
BLOCK_HEIGHT=$((LATEST_HEIGHT - 1000)); \
TRUST_HASH=$(curl -s "$SNAP_RPC/block?height=$BLOCK_HEIGHT" | jq -r .result.block_id.hash)

echo $LATEST_HEIGHT $BLOCK_HEIGHT $TRUST_HASH

sed -i.bak -E "s|^(enable[[:space:]]+=[[:space:]]+).*$|\1true| ; \
s|^(rpc_servers[[:space:]]+=[[:space:]]+).*$|\1\"$SNAP_RPC,$SNAP_RPC\"| ; \
s|^(trust_height[[:space:]]+=[[:space:]]+).*$|\1$BLOCK_HEIGHT| ; \
s|^(trust_hash[[:space:]]+=[[:space:]]+).*$|\1\"$TRUST_HASH\"| ; \
s|^(seeds[[:space:]]+=[[:space:]]+).*$|\1\"\"|" $HOME/.bitsongd/config/config.toml
bitsongd tendermint unsafe-reset-all --home $HOME/.bitsongd
mv $HOME/.bitsongd/priv_validator_state.json.backup $HOME/.bitsongd/data/priv_validator_state.json
wget -O $HOME/.bitsongd/config/addrbook.json "https://server-1.stavr.tech/Mainnet/Bitsong/addrbook.json"
sudo systemctl restart bitsongd && sudo journalctl -fu bitsongd -o cat

SnapShot Mainnet updated every 5 hours

SNAPSHOTS https://server-1.stavr.tech/Mainnet/Bitsong/

cd $HOME
apt install lz4
sudo systemctl stop bitsongd
cp $HOME/.bitsongd/data/priv_validator_state.json $HOME/.bitsongd/priv_validator_state.json.backup
rm -rf $HOME/.bitsongd/data
LATEST_SNAPSHOT=$(curl -s https://server-1.stavr.tech/Mainnet/Bitsong/ | grep -oE 'bitsong-snap-[0-9]+\.tar\.lz4' | while read SNAPSHOT; do HEIGHT=$(curl -s "https://server-1.stavr.tech/Mainnet/Bitsong/${SNAPSHOT%.tar.lz4}-info.txt" | awk '/Block height:/ {print $3}'); echo "$SNAPSHOT $HEIGHT"; done | sort -k2 -nr | head -n 1 | awk '{print $1}')
curl -o - -L https://server-1.stavr.tech/Mainnet/Bitsong/$LATEST_SNAPSHOT | lz4 -c -d - | tar -x -C $HOME/.bitsongd
mv $HOME/.bitsongd/priv_validator_state.json.backup $HOME/.bitsongd/data/priv_validator_state.json
wget -O $HOME/.bitsongd/config/addrbook.json "https://server-1.stavr.tech/Mainnet/Bitsong/addrbook.json"
sudo systemctl restart bitsongd && journalctl -fu bitsongd -o cat

Start

sudo systemctl daemon-reload
sudo systemctl enable bitsongd
sudo systemctl restart bitsongd && sudo journalctl -fu bitsongd -o cat

Create validator

bitsongd tx staking create-validator \
--amount 1000000ubtsg \
--from <walletName> \
--commission-max-change-rate "0.1" \
--commission-max-rate "0.2" \
--commission-rate "0.1" \
--min-self-delegation "1" \
--details="" \
--identity="" \
--pubkey  $(bitsongd tendermint show-validator) \
--moniker "STAVR_Guide" \
--fees 2000ubtsg \
--chain-id bitsong-2b -y

🧩Services and Tools🧩

Monitoring

You can set up your node status alarm here - Monitoring

Security

You can create secure management of your wallet and your node by following this links.

TMKMS Wallet Security

Delete node

sudo systemctl stop bitsongd
sudo systemctl disable bitsongd
rm /etc/systemd/system/bitsongd.service
sudo systemctl daemon-reload
cd $HOME
rm -rf .bitsongd
rm -rf go-bitsong
rm -rf $(which bitsongd)