Skip to main content

Push Node Manager

Push Chain validator management

🚀 Quick Start​

Step 1: Install & Start​

curl -fsSL https://get.push.network/node/install.sh | bash

This installs and starts your validator automatically.

Note: After installation, restart your terminal or run source ~/.bashrc (or ~/.zshrc) to use the push-node-manager command from anywhere.

Step 2: Check Sync Status​

push-node-manager status

Wait for: ✅ Catching Up: false (fully synced)

Step 3: Become a Validator​

push-node-manager register-validator

Requirements:

  • Node must be synced (catching_up: false)
  • Need 2+ PC tokens from faucet
  • Account must be funded first

That's it! You're now running a Push Chain validator! 🎉

📖 Commands​

Essential Commands​

push-node-manager start              # Setup + start node  
push-node-manager stop               # Stop node
push-node-manager status             # Show sync status & validator info
push-node-manager register-validator # Become a validator
push-node-manager logs               # View live logs

Additional Commands​

push-node-manager restart    # Restart node
push-node-manager sync       # Real-time sync monitor
push-node-manager validators # List all validators
push-node-manager balance    # Check wallet balance
push-node-manager reset      # Reset blockchain data
push-node-manager help       # Show all commands

Public Setup Commands (Optional)​

push-node-manager setup-nginx <domain> # Setup NGINX + SSL for public RPC
push-node-manager setup-logs           # Configure log rotation
push-node-manager backup               # Create node backup

📊 Network Info​

🔧 File Locations​

  • Binary: ./build/pchaind
  • Config: ~/.pchain/config/
  • Data: ~/.pchain/data/
  • Keys: ~/.pchain/keyring-test/
  • Logs: ~/.pchain/logs/pchaind.log

🌍 Public Setup (Optional)​

Making Your Node Publicly Accessible​

By default, your validator runs locally. These optional commands help set up public HTTPS endpoints:

Setup NGINX with SSL​

push-node-manager setup-nginx yourdomain.com

Creates:

  • https://yourdomain.com - Cosmos RPC endpoint
  • https://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

Setup Log Rotation​

push-node-manager setup-logs

Configures:

  • Daily log rotation
  • 14-day retention
  • Automatic compression
  • System logrotate integration

Create Backups​

push-node-manager backup
  • Timestamped backup in ~/push-node-backups/
  • Includes all config, keys, and blockchain data
  • Compressed archive with integrity verification