Validator Deployment

OpenGPU Validator Node Setup Guide

Validator nodes are the backbone of the OpenGPU blockchain network. This guide walks you through the complete process of running a validator node on the OpenGPU mainnet.

💡 Requirements

Minimum Hardware Specifications

  • CPU: 4 vCPUs

  • RAM: 32 GB

  • Storage: 1 TB NVMe SSD (preferably local)

  • Connectivity: 1 Gbps symmetric internet connection

  • Operating System: Ubuntu 22.04 or newer LTS (64-bit) recommended

1️⃣ Launch a Server Instance

You can use a cloud provider or a bare metal server.

Network Port Configuration

  • Default TCP/UDP port: 5050

  • Can be customized using --port flag

2️⃣ Install Required Development Tools

Essential Packages and Go Installation (v1.22+)

sudo apt update
sudo apt install -y build-essential

wget https://go.dev/dl/go1.23.4.linux-amd64.tar.gz
sudo tar -xzf go1.23.4.linux-amd64.tar.gz -C /usr/local/
echo "export GOROOT=/usr/local/go" >> ~/.profile
echo "export GOPATH=\$HOME/go" >> ~/.profile
echo "export PATH=\$PATH:\$GOROOT/bin:\$GOPATH/bin" >> ~/.profile
source ~/.profile

3️⃣ Download and Install the OpenGPU Node Software

Download the pre-built binaries from the official release page:

wget https://github.com/oGPUNetwork/ogpu-chain/archive/refs/tags/v1.0.0.tar.gz
tar -xzf v1.0.0.tar.gz

sudo mv ogpu* /usr/local/bin/

4️⃣ Initialize the Validator Database

Download and apply the genesis file:

wget https://raw.githubusercontent.com/oGPUNetwork/ogpu-chain/refs/heads/main/mainnet-genesis.json

GOMEMLIMIT=32GiB ogputool --datadir ~/.opengpu \
  --cache 12000 genesis \
  --mode validator mainnet-genesis.json

5️⃣ Synchronize With the Network

GOMEMLIMIT=32GiB ogpud \
  --datadir ~/.opengpu \
  --cache 12000 \
  --mode validator

Once fully synced, the block "age" should only be a few seconds.

6️⃣ Create a Validator Wallet

To manage your staking, create a wallet:

ogputool --datadir ~/.opengpu account new

🔐 Keep your keys secure and backed up!

7️⃣ Generate Validator Signing Key

ogputool --datadir ~/.opengpu validator new

🔑 Save the public key (starts with 0x...). You’ll need it to register your validator.

8️⃣ Register Your Validator

Register your validator via the staking contract):

  • Staking contract Address: 0x0000000000000000000000000000000000000018

Interact with the smart contract using a Web3-enabled wallet (e.g., MetaMask) and submit the createValidator transaction with your staking amount and validator public key.

9️⃣ Start Your Validator Node

Stop the running node, then start in validator mode:

pkill ogpud

GOMEMLIMIT=32GiB ogpud \
  --datadir ~/.opengpu \
  --cache 12000 \
  --mode validator \
  --validator.id <VALIDATOR_ID> \
  --validator.pubkey <PUBLIC_KEY> \
  --validator.password <PASSWORD_FILE>

✅ Setup Complete!

Congratulations! You are now actively contributing to the OpenGPU network as a validator.

🛡️ Monitoring and Maintenance

  • If your node goes offline, rewards stop.

  • Extended downtime (>3 days) may result in removal from the validator set.

  • Regular monitoring, backups, and log reviews are essential.

🧠 Help and Community

PreviousConsensusNextOGPU Token

Last updated