Blockcast Node Setup Guide

Note: This guide assumes you're running a Linux-based OS with basic terminal knowledge.

📝 Quick Overview

This guide will help you set up a Blockcast node using Docker. You’ll also complete the necessary account setup on the Blockcast platform to link your node for rewards.

🎁 Reward System Details

Blockcast incentivizes participants through a 6-month Proof of Resources Epoch, where rewards are distributed based on your node's performance and contribution to the network.

🏆 Epoch Overview

• Duration: 6 months
• Objective: Reward nodes that contribute network reliability, performance, and decentralization
• Special NFTs will be awarded to top-performing nodes at the end of each epoch

🛠️ System Requirements

✅ Ubuntu-based Linux (tested on 20.04+) / WSL Windows Users (READ HERE)

✅ Docker & Docker Compose

✅ Minimum 2 CPU cores & 4 GB RAM

✅ Open Ports / Port Forwarding (if behind NAT)

✅ Stable Internet Connection

🔐 Account Setup

1. Access the Platform: Blockcast Website
2. Sign Up: Use a valid email address.
3. Connect Wallet: Use a spare Solana wallet.
4. Bind Accounts: Link your Twitter and Discord.

Complete Quests: Navigate to your profile dashboard and finish any available quests.

🐳 Node Auto Installation Steps

Step 1: Clone the Repository

git clone https://github.com/Blockcast/blockcast-node-setup.git
cd blockcast-node-setup

Step 2: Run to install

chmod +x install.sh
./install.sh

Step 3: Complete Registrations

Go to "🔑 Register Your Node" to completing your Node registrations

🐳 Node Manual Installation Steps

Step 1: Update Your System

sudo apt update && sudo apt upgrade -y
sudo apt install ca-certificates curl gnupg lsb-release -y

ufw allow 8080
ufw allow 8080/tcp
ufw allow 8089
ufw allow 8089/tcp

If the ufw (Uncomplicated Firewall) command does require root privileges to run use this :

sudo ufw allow 8080
sudo ufw allow 8080/tcp
sudo ufw allow 8089
sudo ufw allow 8089/tcp

Step 2: Install Docker

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
  sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
  https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin -y

Step 3: Enable Docker

sudo systemctl enable docker
sudo systemctl start docker

Step 4: Verify Installation

docker --version
docker compose version

🔄 Run the Node

Step 1: Clone the Repository

git clone https://github.com/Blockcast/beacon-docker-compose.git
cd beacon-docker-compose

curl -o $HOME/beacon-docker-compose/docker-compose.yml https://raw.githubusercontent.com/molla202/Block-cast/refs/heads/main/docker-compose.yml

Step 2: Start the Node

docker compose up -d

Step 3: Confirm it's Running

docker compose ps -a

Response should be:

NAME                                 IMAGE                             COMMAND                  SERVICE           
beacon-docker-compose-watchtower-1   containrrr/watchtower             "/watchtower"            watchtower 
beacond                              blockcast/cdn_gateway_go:stable   "/usr/bin/beacond -l…"   beacond     
blockcastd                           blockcast/cdn_gateway_go:stable   "/usr/bin/blockcastd…"   blockcastd    
control_proxy                        blockcast/cdn_gateway_go:stable   "/usr/bin/control_pr…"   control_proxy 

🔑 Register Your Node

Step 1: Get Hardware ID and Challenge Key

docker compose exec blockcastd blockcastd init

You'll get something like:

Hardware ID: xxxxxxxxxxxx

Challenge Key: xxxxxxxxxxxx

Register URL : https://app.blockcast.network/register?xxxxx

Step 2: Get location:

curl -s https://ipinfo.io | jq '.city, .region, .country, .loc'

Step 3: Register on the Platform

Click Register URL link shown on Exec or follow tutorial below & Fill-in your location from previous command.

• Go to Blockcast Website
• Login with the same email you signed up with.
• Click "Manage Node" → "Register Node".
• Paste your Hardware ID and Challenge Key.
• Click Submit & Done

Step 3: Check log

It usually takes at least 10 minutes or more to be able to register your node into active/online mode.

docker compose logs -fn 1000

✅ Final Notes

Your node should run 24/7 to remain eligible for rewards. Use a reliable VPS provider if needed:

1. Hetzner : https://www.hetzner.com/cloud/?
2. Contabo : https://contabo.com/en/vps/
3. Analyst VPS Seller : https://t.me/miftaikyy

Usefull Command

1. Project (stop or run)

cd beacon-docker-compose
git pull origin main
docker compose down
docker compose up -d

2. See your Device castID & challengeID

docker compose exec blockcastd blockcastd init

📬 Need Help?

Join the AirdropAnalystChat or Blockcast Discord open an issue in the repo for support.