Drosera CLI Node Guide
🌿 Drosera CLI Node Guide

Earn $DORA Tokens Before Mainnet
Drosera Network empowers decentralized observability and rewards operators for running "Traps" that monitor smart contract behavior. This guide walks you through setting up your own Drosera Operator Node to earn DORA tokens before mainnet launch.
📋 System Requirements
To run a Drosera Node efficiently, ensure your VPS meets the following specifications:
CPU: 2 Cores
RAM: 4 GB
Disk Space: 20 GB
OS: Ubuntu 20.04 or higher recommended
🛠️ Step 1: Install Prerequisites
🔄 Update Your System
sudo apt update && sudo apt upgrade -y && \
sudo apt autoremove📟 Open a Screen Session
screen -S Drosera🔐 Configure Firewall
sudo ufw allow ssh && \
sudo ufw allow 22 && \
sudo ufw enable && \
sudo ufw allow 31313/tcp && \
sudo ufw allow 31314/tcp && \
sudo ufw reload🐳 Install Docker (Skip if already installed)
sudo apt install apt-transport-https ca-certificates curl software-properties-common && \
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg && \
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.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 -y && sudo apt upgrade -y && \
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin && \
sudo systemctl status docker🧠 Step 2: Install & Setup Drosera Trap
🚀 Install Drosera CLI
curl -L https://app.drosera.io/install | bash && \
source ~/.bashrc && \
droseraup⚙️ Install Foundry CLI
curl -L https://foundry.paradigm.xyz | bash && \
source ~/.bashrc && \
foundryup🧵 Install Bun
curl -fsSL https://bun.sh/install | bash🏗️ Step 3: Deploy Your Trap
📁 Initialize Project
mkdir my-drosera-trap && cd my-drosera-trap
git config --global user.email "your_email@example.com"
git config --global user.name "YourGithubUsername"Replace with your actual GitHub email and username.
⚒️ Scaffold & Build
forge init -t drosera-network/trap-foundry-template
bun install
forge build⚠️ Warnings during
forge buildare safe to ignore.
🚀 Deploy Trap
DROSERA_PRIVATE_KEY=yourEVMPrivateKey drosera applyReplace
yourEVMPrivateKey(without0x) and ensure your wallet has ETH on Holesky testnet.
✅ Check Your Trap
Go to https://app.drosera.io
Click "Traps Owned"
Confirm your deployed trap
💥 Boost Your Trap
Click "Send Bloom Boost", stake any amount of ETH, and confirm the transaction in Metamask.
⛓️ Fetch Some Blocks
drosera dryrun🔐 Step 4: Whitelist Your Address
Edit drosera.toml:
cd $HOME/my-drosera-trap
sudo sed -i 's/^private_trap *= *.*/private_trap = true/' drosera.toml
sudo sed -i 's/^whitelist *= *\[\s*\]/whitelist = ["YOUR_ETH_ADDRESS"]/' drosera.tomlReplace
YOUR_ETH_ADDRESSwith your actual wallet address.
🔄 Reapply Configuration
DROSERA_PRIVATE_KEY=yourEVMPrivateKey drosera apply⚙️ Step 5: Install Drosera Operator CLI
📦 Download Binary
cd $HOME
curl -s https://api.github.com/repos/drosera-network/releases/releases/latest | \
grep -Po '"tag_name": "\K.*?(?=")' | \
xargs -I {} wget https://github.com/drosera-network/releases/releases/download/{}/drosera-operator-{}-x86_64-unknown-linux-gnu.tar.gz
tar -xvf drosera-operator-*-x86_64-unknown-linux-gnu.tar.gz🧪 Test & Install CLI
./drosera-operator --version
sudo cp drosera-operator /usr/bin
drosera-operator🐳 Step 6: Register Operator with Docker
Pull Operator Image
docker pull ghcr.io/drosera-network/drosera-operator:latestRegister Your Operator
drosera-operator register --eth-rpc-url https://ethereum-holesky-rpc.publicnode.com --eth-private-key yourEVMPrivateKeyReplace
yourEVMPrivateKeywithout the0xprefix.
🚀 Step 7: Run the Drosera Operator
📥 Clone & Configure
git clone https://github.com/0xmoei/Drosera-Network && \
cd Drosera-Network && \
cp .env.example .envEdit .env:
sudo sed -i 's/^ETH_PRIVATE_KEY=.*/ETH_PRIVATE_KEY=yourEVMPrivateKey/' .env
sudo sed -i 's/^\(VPS_IP=\)your_vps_public_ip/\1your.actual.vps.ip/' .env🔄 Start Operator
docker compose up -d
docker compose logs -f🔗 Step 8: Connect to Drosera Dashboard
Go to https://app.drosera.io
Locate your Trap
Click "Opt In" and confirm the transaction
✅ You’re live if the green square is shown under “Operator Status”.
🛠️ Node Management Commands
Stop Node
cd ~/Drosera-Network && docker compose down -v
Restart Node
cd ~/Drosera-Network && docker restart drosera
📌 Additional Resources
🎉 Congratulations!
Your Drosera CLI node is now up and running. You’re actively contributing to decentralized observability and earning rewards in the process. Don’t forget to stay tuned for updates and mainnet launch announcements!
Last updated