PushChain Node Installation Guide (push_42101-1)

📋 Hardware Requirements

Component	Minimum	Recommended
CPU	4 Cores	8 Cores
RAM	8 GB	16 GB
SSD	200 GB NVMe	500 GB NVMe
OS	Ubuntu 24.04	Ubuntu 24.04

🛠 Installation Steps

1. System Update & Dependencies

sudo apt update && sudo apt upgrade -y
sudo apt install curl git wget htop tmux build-essential jq make lz4 gcc unzip -y

2. Install Go

cd $HOME
VER="1.25.5"
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"
echo "export PATH=$PATH:/usr/local/go/bin:~/go/bin" >> ~/.bash_profile
source $HOME/.bash_profile

3. Configure Environment Variables

echo "export WALLET="wallet"" >> $HOME/.bash_profile
echo "export MONIKER="test"" >> $HOME/.bash_profile
echo "export PUSH_CHAIN_ID="push_42101-1"" >> $HOME/.bash_profile
echo "export PUSH_PORT="30"" >> $HOME/.bash_profile
source $HOME/.bash_profile

4. Install Binary & Cosmovisor

We are setting up Cosmovisor to ensure the node handles upgrades automatically.

# Install Cosmovisor
go install github.com/cosmos/cosmos-sdk/cosmovisor/cmd/cosmovisor@latest

# Download and Prepare Binary
cd $HOME
rm -rf ~/bin
wget -O push.tar.gz https://github.com/pushchain/push-chain-node/releases/download/v0.0.30/push-chain_0.0.30_linux_amd64.tar.gz
tar -xvf push.tar.gz
chmod +x ~/bin/pchaind

# Create Cosmovisor structure
mkdir -p $HOME/.pchain/cosmovisor/genesis/bin
mkdir -p $HOME/.pchain/cosmovisor/upgrades
cp ~/bin/pchaind $HOME/.pchain/cosmovisor/genesis/bin/

# Create symlink to make pchaind available globally
sudo ln -s $HOME/.pchain/cosmovisor/genesis/bin/pchaind /usr/local/bin/pchaind

5. Node Configuration & Initialization

pchaind config node tcp://localhost:${PUSH_PORT}657
pchaind config keyring-backend os
pchaind config chain-id push_42101-1
pchaind init $MONIKER --chain-id push_42101-1

# Genesis and Addrbook
wget -O $HOME/.pchain/config/genesis.json https://server-4.itrocket.net/testnet/push/genesis.json
wget -O $HOME/.pchain/config/addrbook.json  https://server-4.itrocket.net/testnet/push/addrbook.json

# Seeds and Peers
SEEDS="a8d3377ef5f091980a425b84380655865c0f2320@push-testnet-seed.itrocket.net:30656"
PEERS="1160dc307b84b47e430cc23a4cb266d4d767e233@push-testnet-peer.itrocket.net:30656,968576b35b18a7dbc25ee46d65673c6f788c13b3@152.53.230.108:26656,80f6c4720cd46ba6d8b3af798d48b7b35edc022f@82.27.2.100:26656,d2a1f2a83858d483ed05c5f094a65d1dd463de78@34.57.236.39:26656"
sed -i -e "/^\[p2p\]/,/^\[/{s/^[[:space:]]*seeds *=.*/seeds = \"$SEEDS\"/}" -e "/^\[p2p\]/,/^\[/{s/^[[:space:]]*persistent_peers *=.*/persistent_peers = \"$PEERS\"/}" $HOME/.pchain/config/config.toml

# Custom Ports
sed -i.bak -e "s%:1317%:${PUSH_PORT}317%g; s%:8080%:${PUSH_PORT}080%g; s%:9090%:${PUSH_PORT}090%g; s%:9091%:${PUSH_PORT}091%g; s%:8545%:${PUSH_PORT}545%g; s%:8546%:${PUSH_PORT}546%g; s%:6065%:${PUSH_PORT}065%g" $HOME/.pchain/config/app.toml
sed -i.bak -e "s%:26658%:${PUSH_PORT}658%g; s%:26657%:${PUSH_PORT}657%g; s%:6060%:${PUSH_PORT}060%g; s%:26656%:${PUSH_PORT}656%g; s%^external_address = \"\"%external_address = \"$(wget -qO- eth0.me):${PUSH_PORT}656\"%; s%:26660%:${PUSH_PORT}660%g" $HOME/.pchain/config/config.toml

# Pruning & Indexer
sed -i -e "s/^pruning *=.*/pruning = \"custom\"/" $HOME/.pchain/config/app.toml 
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"100\"/" $HOME/.pchain/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"19\"/" $HOME/.pchain/config/app.toml
sed -i 's|minimum-gas-prices =.*|minimum-gas-prices = "1000000000upc"|g' $HOME/.pchain/config/app.toml
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.pchain/config/config.toml
sed -i -e "s/^indexer *=.*/indexer = \"null\"/" $HOME/.pchain/config/config.toml

6. Create Systemd Service (Cosmovisor)

sudo tee /etc/systemd/system/pchaind.service > /dev/null <<EOF
[Unit]
Description=PushChain Node (Cosmovisor)
After=network-online.target

[Service]
User=$USER
WorkingDirectory=$HOME/.pchain
ExecStart=$(which cosmovisor) run start --home $HOME/.pchain
Restart=on-failure
RestartSec=5
LimitNOFILE=65535
Environment="DAEMON_NAME=pchaind"
Environment="DAEMON_HOME=$HOME/.pchain"
Environment="DAEMON_ALLOW_STRUCTURAL_ADDITIONS=true"
Environment="UNSAFE_SKIP_BACKUP=true"

[Install]
WantedBy=multi-user.target
EOF

7. Snapshot & Start

pchaind tendermint unsafe-reset-all --home $HOME/.pchain
curl https://server-4.itrocket.net/testnet/push/push_2026-04-10_13229772_snap.tar.lz4 | lz4 -dc - | tar -xf - -C $HOME/.pchain

sudo systemctl daemon-reload
sudo systemctl enable pchaind
sudo systemctl restart pchaind && sudo journalctl -u pchaind -fo cat

---

🔑 Wallet & Validator Setup

Create Wallet

pchaind keys add $WALLET
# OR restore
pchaind keys add $WALLET --recover

Create Validator

Ensure your node is synced (catching_up: false):

pchaind status 2>&1 | jq .SyncInfo.catching_up

Create validator.json:

echo "{\"pubkey\":{\"@type\":\"/cosmos.crypto.ed25519.PubKey\",\"key\":\"$(pchaind comet show-validator | grep -Po '\"key\":\s*\"\K[^"]*')\"},
    \"amount\": \"1000000upc\",
    \"moniker\": \"$MONIKER\",
    \"identity\": \"\",
    \"website\": \"\",
    \"security\": \"\",
    \"details\": \"\",
    \"commission-rate\": \"0.1\",
    \"commission-max-rate\": \"0.2\",
    \"commission-max-change-rate\": \"0.01\",
    \"min-self-delegation\": \"1\"
}" > validator.json

pchaind tx staking create-validator validator.json \
    --from $WALLET \
    --chain-id push_42101-1 \
    --gas auto --gas-adjustment 1.5 -y --fees 111333000000000upc

---

🗑 Uninstall

sudo systemctl stop pchaind
sudo systemctl disable pchaind
sudo rm -rf /etc/systemd/system/pchaind.service
sudo rm $(which pchaind)
sudo rm -rf $HOME/.pchain
sed -i "/PUSH_/d" $HOME/.bash_profile