🔮 Prysm Devnet Full Node & Validator Setup Guide
A complete guide to running a Prysm devnet full node and registering as a validator
System preparation, binary build, Cosmovisor setup, and validator creation — step by step.
Network: Prysm Devnet (Chain ID: prysm-devnet-1)
Version: v0.1.0-devnet
Last Updated: May 2026
Table of Contents
- Hardware Requirements
- Network Endpoints
- Step 1 — System Verification
- Step 2 — System Update and Dependencies
- Step 3 — Install Go
- Step 4 — Build Binary from Source
- Step 5 — Install Cosmovisor
- Step 6 — Create Systemd Service
- Step 7 — Initialize the Node
- Step 8 — Download Genesis and Addrbook
- Step 9 — Configure Ports and Pruning
- Step 10 — Configure Seeds and Peers
- Step 11 — Start the Node
- Step 12 — Create a Wallet
- Step 13 — Register as a Validator
- Monitoring the Node
- Useful Commands
Hardware Requirements
| Component | Minimum | Recommended |
|---|---|---|
| Operating System | Ubuntu 22.04+ | Ubuntu 24.04 |
| CPU | 4 cores | 8 cores |
| RAM | 8 GB | 16 GB |
| Disk | 200 GB NVMe SSD | 500 GB NVMe SSD |
| Network | 100 Mbps | 1 Gbps |
Network Endpoints
| Type | Endpoint |
|---|---|
| RPC | https://prysm-testnet-rpc.itrocket.net |
| Seed | prysm-testnet-seed.itrocket.net:25656 |
| GitHub | https://github.com/kleomedes/prysm |
Step 1 — System Verification
After SSH-ing into your server, verify the system meets requirements:
lsb_release -a # Should be Ubuntu 22.04 or higher
uname -r # Kernel version
lscpu | grep -E "Model name|CPU\(s\)|Thread|Socket|Core"
free -h # Minimum 8 GB RAM
df -h # Minimum 200 GB free disk
Step 2 — System Update and Dependencies
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git wget htop tmux build-essential jq make lz4 gcc unzip
Step 3 — Install Go
cd $HOME
VER="1.23.0"
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:\$HOME/go/bin" >> ~/.bash_profile
source $HOME/.bash_profile
[ ! -d ~/go/bin ] && mkdir -p ~/go/bin
Verify the installation:
go version
Expected output: go version go1.23.0 linux/amd64
Step 4 — Build Binary from Source
cd $HOME
rm -rf prysm
git clone https://github.com/kleomedes/prysm prysm
cd prysm
git checkout v0.1.0-devnet
make install
Set up Cosmovisor directory structure:
mkdir -p $HOME/.prysm/cosmovisor/genesis/bin
cp $HOME/go/bin/prysmd $HOME/.prysm/cosmovisor/genesis/bin/
sudo ln -sfn $HOME/.prysm/cosmovisor/genesis $HOME/.prysm/cosmovisor/current
sudo ln -sfn $HOME/.prysm/cosmovisor/current/bin/prysmd /usr/local/bin/prysmd
Verify:
prysmd version
Expected output: v0.1.0-devnet
Step 5 — Install Cosmovisor
go install cosmossdk.io/tools/cosmovisor/cmd/[email protected]
Verify:
cosmovisor version
Step 6 — Create Systemd Service
Set your moniker and port prefix:
MONIKER="YOUR_MONIKER"
PORT="25" # Default Prysm port prefix. Change to avoid conflicts if needed.
Create the service file:
sudo tee /etc/systemd/system/prysmd.service > /dev/null << EOF
[Unit]
Description=Prysm Node Service
After=network-online.target
[Service]
User=$USER
ExecStart=$(which cosmovisor) run start
Restart=on-failure
RestartSec=10
LimitNOFILE=65535
Environment="DAEMON_HOME=$HOME/.prysm"
Environment="DAEMON_NAME=prysmd"
Environment="UNSAFE_SKIP_BACKUP=true"
Environment="LD_LIBRARY_PATH=$HOME/.prysm/lib"
Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin:$HOME/.prysm/cosmovisor/current/bin"
[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable prysmd
Step 7 — Initialize the Node
prysmd config set client chain-id prysm-devnet-1
prysmd config set client keyring-backend test
prysmd config set client node tcp://localhost:${PORT}657
prysmd init $MONIKER --chain-id prysm-devnet-1
Set environment variables permanently:
echo "export MONIKER=$MONIKER" >> $HOME/.bash_profile
echo "export PRYSM_CHAIN_ID=\"prysm-devnet-1\"" >> $HOME/.bash_profile
echo "export PRYSM_PORT=$PORT" >> $HOME/.bash_profile
source $HOME/.bash_profile
Step 8 — Download Genesis and Addrbook
curl -Ls https://raw.githubusercontent.com/hazennetworksolutions/prysm/refs/heads/main/genesis.json \
> $HOME/.prysm/config/genesis.json
wget -O $HOME/.prysm/config/addrbook.json \
https://raw.githubusercontent.com/hazennetworksolutions/prysm/refs/heads/main/addrbook.json
Verify genesis:
sha256sum $HOME/.prysm/config/genesis.json
Step 9 — Configure Ports and Pruning
Custom Ports
sed -i.bak -e "s%:1317%:${PRYSM_PORT}317%g;
s%:8080%:${PRYSM_PORT}080%g;
s%:9090%:${PRYSM_PORT}090%g;
s%:9091%:${PRYSM_PORT}091%g;
s%:8545%:${PRYSM_PORT}545%g;
s%:8546%:${PRYSM_PORT}546%g;
s%:6065%:${PRYSM_PORT}065%g" $HOME/.prysm/config/app.toml
sed -i.bak -e "s%:26658%:${PRYSM_PORT}658%g;
s%:26657%:${PRYSM_PORT}657%g;
s%:6060%:${PRYSM_PORT}060%g;
s%:26656%:${PRYSM_PORT}656%g;
s%^external_address = \"\"%external_address = \"$(wget -qO- eth0.me):${PRYSM_PORT}656\"%;
s%:26660%:${PRYSM_PORT}660%g" $HOME/.prysm/config/config.toml
Gas Prices
sed -i -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0.00001uprysm\"/" \
$HOME/.prysm/config/app.toml
Pruning
sed -i -e "s/^pruning *=.*/pruning = \"custom\"/" $HOME/.prysm/config/app.toml
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"100\"/" $HOME/.prysm/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"19\"/" $HOME/.prysm/config/app.toml
Enable Prometheus (optional)
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.prysm/config/config.toml
Disable Indexer (saves disk space)
sed -i -e "s/^indexer *=.*/indexer = \"null\"/" $HOME/.prysm/config/config.toml
Step 10 — Configure Seeds and Peers
SEEDS="1b5b6a532e24c91d1bc4491a6b989581f5314ea5@prysm-testnet-seed.itrocket.net:25656"
PEERS="[email protected]:61256,ff15df83487e4aa8d2819452063f336269958d09@prysm-testnet-rpc.itrocket.net:25656,01e40fe961c9522936a8bb7ede533198614abf9f@prysm-testnet-rpc.stakerhouse.com:14256,[email protected]:15656,[email protected]:26916"
sed -i -e "/^\[p2p\]/,/^\[/{s/^[[:space:]]*seeds *=.*/seeds = \"$SEEDS\"/}" \
-e "/^\[p2p\]/,/^\[/{s/^[[:space:]]*persistent_peers *=.*/persistent_peers = \"$PEERS\"/}" \
$HOME/.prysm/config/config.toml
Step 11 — Start the Node
sudo systemctl start prysmd
sudo journalctl -u prysmd -f --no-pager -o cat
Verify the service is running:
sudo systemctl status prysmd --no-pager
The service should show active (running).
Check sync status:
prysmd status 2>&1 | jq .SyncInfo
Wait until catching_up is false before proceeding to validator registration.
Step 12 — Create a Wallet
prysmd keys add wallet --keyring-backend test
⚠️ CRITICAL: Save your mnemonic phrase in a secure location. Without it, you cannot recover your wallet.
To recover an existing wallet:
prysmd keys add wallet --recover --keyring-backend test
Check your balance:
prysmd query bank balances $(prysmd keys show wallet -a --keyring-backend test)
Step 13 — Register as a Validator
The node must be fully synced before creating a validator.
Get your pubkey:
prysmd comet show-validator
Create validator JSON:
cat > $HOME/validator.json << EOF
{
"pubkey": $(prysmd comet show-validator),
"amount": "1000000uprysm",
"moniker": "YOUR_MONIKER",
"identity": "",
"website": "",
"security": "",
"details": "",
"commission-rate": "0.05",
"commission-max-rate": "0.20",
"commission-max-change-rate": "0.01",
"min-self-delegation": "1"
}
EOF
Submit the transaction:
prysmd tx staking create-validator $HOME/validator.json \
--from wallet \
--chain-id prysm-devnet-1 \
--keyring-backend test \
--gas auto \
--gas-adjustment 1.4 \
--fees 500uprysm \
-y
Verify your validator:
prysmd query staking validator \
$(prysmd keys show wallet --bech val -a --keyring-backend test)
Monitoring the Node
Watch live block commits:
sudo journalctl -u prysmd -f --no-pager | grep "committed block"
Full logs:
sudo journalctl -u prysmd -f --no-pager
Sync status:
prysmd status 2>&1 | jq .SyncInfo
Service management:
# Restart service
sudo systemctl restart prysmd
# Stop service
sudo systemctl stop prysmd
# Check status
sudo systemctl status prysmd
Useful Commands
Wallet
# List wallets
prysmd keys list --keyring-backend test
# Show wallet address
prysmd keys show wallet -a --keyring-backend test
# Check balance
prysmd query bank balances $(prysmd keys show wallet -a --keyring-backend test)
Staking
# Delegate tokens
prysmd tx staking delegate \
$(prysmd keys show wallet --bech val -a --keyring-backend test) 1000000uprysm \
--from wallet --chain-id prysm-devnet-1 --keyring-backend test \
--gas auto --gas-adjustment 1.4 --fees 500uprysm -y
# Redelegate tokens
prysmd tx staking redelegate \
$(prysmd keys show wallet --bech val -a --keyring-backend test) <NEW_VALOPER> 1000000uprysm \
--from wallet --chain-id prysm-devnet-1 --keyring-backend test \
--gas auto --gas-adjustment 1.4 --fees 500uprysm -y
# Undelegate tokens
prysmd tx staking unbond \
$(prysmd keys show wallet --bech val -a --keyring-backend test) 1000000uprysm \
--from wallet --chain-id prysm-devnet-1 --keyring-backend test \
--gas auto --gas-adjustment 1.4 --fees 500uprysm -y
Rewards
# Withdraw all rewards
prysmd tx distribution withdraw-all-rewards \
--from wallet --chain-id prysm-devnet-1 --keyring-backend test \
--gas auto --gas-adjustment 1.4 --fees 500uprysm -y
# Withdraw commission
prysmd tx distribution withdraw-rewards \
$(prysmd keys show wallet --bech val -a --keyring-backend test) --commission \
--from wallet --chain-id prysm-devnet-1 --keyring-backend test \
--gas auto --gas-adjustment 1.4 --fees 500uprysm -y
Governance
# List proposals
prysmd query gov proposals
# Vote on a proposal
prysmd tx gov vote 1 yes \
--from wallet --chain-id prysm-devnet-1 --keyring-backend test \
--gas auto --gas-adjustment 1.4 --fees 500uprysm -y
Validator Operations
# Edit validator
prysmd tx staking edit-validator \
--new-moniker "NEW_MONIKER" \
--identity "" \
--from wallet --chain-id prysm-devnet-1 --keyring-backend test \
--gas auto --gas-adjustment 1.4 --fees 500uprysm -y
# Unjail validator
prysmd tx slashing unjail \
--from wallet --chain-id prysm-devnet-1 --keyring-backend test \
--gas auto --gas-adjustment 1.4 --fees 500uprysm -y
# Check validator signing info
prysmd query slashing signing-info $(prysmd comet show-validator)
Guide maintained by HazenNetworkSolutions