Fast validator setup for Push Chain
curl -fsSL https://get.push.network/node/install.sh | bashAutomatically installs and starts your validator using snapshot download (no full sync needed).
Note: Restart terminal or run
source ~/.bashrcto usepush-validatorfrom anywhere.
push-validator statusWait for: ✅ Catching Up: false (snapshot download takes ~5-20 mins depending on connection, then block sync begins)
push-validator register-validatorWallet Setup: You'll be prompted to either:
- Create new wallet — Generates a new recovery phrase (save it securely!)
- Import existing wallet — Use your existing 12/24-word recovery phrase
Configuration: You'll also set:
- Moniker — Your validator's display name (must be unique on the network)
- Commission Rate — Fee charged to delegators (5-100%, default: 10%)
- Stake Amount — How much to stake (minimum: 1.5 PC)
Requirements: 2+ PC tokens from faucet
Done! Your validator is running with automatic recovery enabled! 🎉
Monitor your validator in real-time with an interactive dashboard:
push-validator dashboardFeatures:
- Node Status - Process state, RPC connectivity, resource usage (CPU, memory, disk)
- Chain Sync - Real-time block height, sync progress with ETA, network latency
- Validator Metrics - Bonding status, voting power, commission rate, accumulated rewards
- Network Overview - Connected peers, chain ID, active validators list
- Live Logs - Stream node activity with search and filtering
- Auto-Refresh - Updates every 2 seconds for real-time monitoring
The dashboard provides everything you need to monitor validator health and performance at a glance.
push-validator start # Start node with snapshot sync
push-validator stop # Stop node
push-validator status # Check sync & validator status
push-validator dashboard # Live interactive monitoring dashboard
push-validator register-validator # Register as validator (create or import wallet)
push-validator logs # View logspush-validator increase-stake # Increase validator stake and voting power
push-validator unjail # Restore jailed validator to active status
push-validator withdraw-rewards # Withdraw validator rewards and commission
push-validator restake-rewards # Auto-withdraw and restake all rewards to increase validator powerpush-validator sync # Monitor sync progress
push-validator peers # Show peer connections (from local RPC)
push-validator doctor # Run diagnostic checks on validator setuppush-validator restart # Restart node
push-validator validators # List validators (supports --output json)
push-validator balance # Check balance (defaults to validator key)
push-validator reset # Reset chain data (keeps address book)
push-validator full-reset # ⚠️ Complete reset (deletes ALL keys and data)
push-validator backup # Backup config and validator state
push-validator update # Update CLI to latest version- Snapshot Download: Fast sync (~5-20 mins, no full blockchain download required)
- Interactive Logs: Real-time log viewer with search and filtering
- Smart Detection: Monitors for sync stalls and network issues
- Reliable Snapshots: Uses trusted RPC nodes for recovery
- Multiple Outputs: JSON, YAML, or text format support
Your validator uses Cosmovisor for seamless, zero-downtime upgrades.
- Governance Proposal - Network votes on upgrade proposal specifying target block height
- Auto-Download - When approved, Cosmovisor automatically downloads the new binary
- Checksum Verification - Binary verified via SHA256 before use
- Seamless Switch - At upgrade height, node stops, switches binary, and restarts automatically
No manual intervention required - your validator stays up-to-date automatically.
~/.pchain/cosmovisor/
├── genesis/bin/pchaind # Initial binary
├── upgrades/ # Upgrade binaries (auto-populated)
│ └── {upgrade-name}/bin/pchaind
└── current -> genesis/ # Symlink to active version
push-validator cosmovisor status # Check versions & pending upgradesIf you encounter sync failures or app hash mismatch errors, reset and restart:
push-validator reset
push-validator startThis clears the chain data and downloads a fresh snapshot. Snapshot download takes approximately 15-30 minutes depending on your connection, after which block sync will begin automatically.
- Chain:
push_42101-1(Testnet) - Min Stake: 1.5 PC
- Faucet: https://faucet.push.org
- Explorer: https://donut.push.network
The CLI automatically checks for updates and notifies you:
- Dashboard: Shows notification in header when update available
- CLI commands: Shows notification after command completes
push-validator update # Update to latest version
push-validator update --check # Check only, don't install
push-validator update --version v1.2.0 # Install specific versionUpdates download pre-built binaries from GitHub Releases with checksum verification.
bash scripts/setup-nginx.sh yourdomain.comCreates:
https://yourdomain.com- Cosmos RPC endpointhttps://evm.yourdomain.com- EVM RPC endpoint- Automatic SSL certificates via Let's Encrypt
- Rate limiting and security headers
Requirements:
- Domain pointing to your server IP
- Ports 80/443 open
- Ubuntu/Debian system
bash scripts/setup-log-rotation.shConfigures daily rotation with 14-day retention and compression.
- Manager:
~/.local/bin/push-validator - Chain Binary:
~/.pchain/cosmovisor/current/bin/pchaind(managed by Cosmovisor) - Config:
~/.pchain/config/ - Data:
~/.pchain/data/ - Logs:
~/.pchain/logs/pchaind.log - Backups:
~/push-node-backups/