Celestia

🚀 PostHuman Celestia Full Storage Node Setup Guide

This guide will help you set up a Celestia Full Storage Node using PostHuman infrastructure.

---

🔧 Hardware Requirements

Ensure your server meets the minimum requirements for running a Celestia full storage node.

---

📦 1. Update Packages and Install Dependencies

sudo apt update && sudo apt upgrade -y
sudo apt install curl git wget htop tmux build-essential jq make gcc tar clang pkg-config libssl-dev ncdu -y

---

🛠 2. Install Go

cd ~
! [ -x "$(command -v go)" ] && {
  VER="1.22.6"
  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:~/go/bin" >> ~/.bash_profile
  source ~/.bash_profile
}
[ ! -d ~/go/bin ] && mkdir -p ~/go/bin
go version

---

📥 3. Install Celestia Node

cd $HOME
rm -rf celestia-node
git clone https://github.com/celestiaorg/celestia-node.git
cd celestia-node/
git checkout tags/v0.21.5
make build
sudo make install
make cel-key

---

🔑 4. Create a Wallet

./cel-key add my_celes_key --keyring-backend test --node.type full

(Optional) Restore an Existing Wallet

cd ~/celestia-node
./cel-key add my_celes_key --keyring-backend test --node.type full --recover

Retrieve your wallet address:

cd $HOME/celestia-node
./cel-key list --node.type full --keyring-backend test

---

⚙️ 5. Configure and Initialize the Full Storage Node

celestia full init --core.ip $CORE_IP

---

📡 6. Set Consensus Node RPC and gRPC Ports

CORE_IP="<PUT_CONSENSUS_NODE_IP>"
CORE_RPC_PORT="<PUT_CONSENSUS_NODE_RPC_PORT>"
CORE_GRPC_PORT="<PUT_CONSENSUS_NODE_GRPC_PORT>"
KEY_NAME="my_celes_key"

---

🔄 7. Create a Service File for Celestia Full Storage Node

sudo tee /etc/systemd/system/celestia-bridge.service > /dev/null <<EOF
[Unit]
Description=celestia Bridge
After=network-online.target

[Service]
User=$USER
ExecStart=$(which celestia) bridge start --archival \
--metrics.tls=true --metrics --metrics.endpoint otel.celestia.observer
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

Enable and start the service:

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

---

📡 8. Retrieve Node Peer ID

Generate an auth token:

NODE_TYPE=full
AUTH_TOKEN=$(celestia $NODE_TYPE auth admin)

Get the peer ID:

curl -X POST \
     -H "Authorization: Bearer $AUTH_TOKEN" \
     -H 'Content-Type: application/json' \
     -d '{"jsonrpc":"2.0","id":0,"method":"p2p.Info","params":[]}' \
     http://localhost:26658

---

📖 9. Useful Commands (Cheat Sheet)

💰 Check Wallet Balance

celestia state balance --node.store ~/.celestia-full/

📜 Get Wallet Address

cd $HOME/celestia-node
./cel-key list --node.type full --keyring-backend test

🔄 Restore an Existing Key

KEY_NAME="my_celes_key"
cd ~/celestia-node
./cel-key add $KEY_NAME --keyring-backend test --node.type full --recover

📊 Check Node Sync Status

celestia header sync-state --node.store ~/.celestia-full/

🔍 Get Node ID

celestia p2p info --node.store ~/.celestia-full/

🔐 Add Permissions for Key Transfers

chmod -R 700 ~/.celestia-full

🔄 Reset Node

celestia full unsafe-reset-store

---

🔄 10. Upgrade Instructions

🛑 Stop Full Storage Node

sudo systemctl stop celestia-full

📥 Download Latest Version

cd $HOME
rm -rf celestia-node
git clone https://github.com/celestiaorg/celestia-node.git
cd celestia-node/
git checkout tags/v0.21.5
make build
sudo make install
make cel-key

🔄 Update Configuration

celestia full config-update

🚀 Restart Full Storage Node

sudo systemctl restart celestia-full && sudo journalctl -u celestia-full -fo cat

---

🗑 11. Delete Full Storage Node

sudo systemctl stop celestia-full
sudo systemctl disable celestia-full
sudo rm /etc/systemd/system/celestia-full*
rm -rf $HOME/celestia-node $HOME/.celestia-app $HOME/.celestia-full

---

🔍 12. External Explorer

View node information here: 🔗 Celestia PostHuman Explorer

This guide is customized for PostHuman Celestia Mainnet using the following endpoints:

• Mainnet Type: mainnet
• Chain ID: celestia
• RPC: https://rpc.celestia-mainnet.posthuman.digital
• REST: https://rest.celestia-mainnet.posthuman.digital
• gRPC: https://grpc.celestia-mainnet.posthuman.digital
• Peer: cd9f852141cd6f78e9443cea389911a6f0a5df72@8.52.247.252:26656

🚀 Your Celestia Full Storage Node is now up and running on PostHuman infrastructure!

POSTHUMAN © 2025. All Rights Reserved.