Before starting, make sure you have the following:
A Linux server (Ubuntu 20.04/22.04) with at least:
4 CPUs
8 GB RAM
200 GB SSD storage
A static public IP address
Basic command-line knowledge.
Docker and Docker Compose installed on your server.
BounceBit Wallet to receive rewards.
A stable internet connection for uninterrupted uptime.
Start by updating your server and installing necessary tools:
# Update packages and install dependencies
sudo apt update && sudo apt upgrade -y
sudo apt install curl wget git build-essential -y
# Install Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER
# Install Docker Compose
sudo apt install docker-compose -y
Log out and log back in to apply Docker permissions.
Next, download the BounceBit node repository:
# Clone the BounceBit repository
git clone https://github.com/bouncebit/bouncebit-node.git
cd bouncebit-node
Edit the configuration file to set up your node. Replace <YOUR_WALLET_ADDRESS> with your actual BounceBit wallet address:
nano config/config.toml
Update the following fields:
[validator]
address = "<YOUR_WALLET_ADDRESS>" # Replace with your BounceBit wallet address
Save the file (CTRL + O, then CTRL + X).
To start the node, use the provided Docker Compose configuration:
# Start the BounceBit node
docker-compose up -d
This will download and run the necessary Docker containers. Check the logs to verify that the node is running:
docker-compose logs -f
The node will need to sync the BounceBit blockchain. This process can take a few hours depending on your server's performance and network speed. Monitor the logs to track the progress:
docker logs -f bouncebit-node
Once you see a message like Node is fully synced, your node is ready.
To participate as a validator:
Obtain the public key of your node:
docker exec bouncebit-node ./bouncebit-cli get-validator-keySubmit your public key to the BounceBit staking portal:
Visit BounceBit Staking Dashboard.
Register your validator using the public key and your wallet address.
Delegate some BounceBit tokens (BBT) to your validator to activate it.
Ensure your node remains online and performant. Use these commands:
Check Node Status:
docker exec bouncebit-node ./bouncebit-cli statusRestart Node (if needed):
docker-compose restartUpdate Node Software: Pull the latest updates from the repository and restart:
git pull docker-compose down docker-compose up -d
Check Logs:
docker-compose logs -fDisk Space Issues: Ensure you have at least 200 GB free storage. Clean up unused Docker containers and images:
docker system prune -a
Enable a Firewall:
sudo ufw allow ssh sudo ufw allow 26656/tcp # Replace with BounceBit’s P2P port sudo ufw enableSet Up Automatic Restarts: Configure Docker to restart the node on failure:
docker update --restart unless-stopped bouncebit-node

