Indexer

✅ Indexer v4.1.0

⚠️ Testnet Only - Setup Namada Indexer with Docker Compose and persistent PostgreSQL data.

🛠 Prerequisites

System Requirements

- Ubuntu 20.04+ or Debian-based system
- 4GB+ RAM recommended
- 50GB+ free disk space

Install Required Packages

sudo apt-get update
sudo apt-get install -y curl apt-transport-https ca-certificates \
software-properties-common git nano build-essential jq

Install Docker & Docker Compose

# Install Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER

# Install Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" \
  -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

Install Rust and Just (Task Runner)

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

cargo install just

✅ Fresh Installation

Step 1: Clone Namada Indexer

cd /var/www/
git clone https://github.com/anoma/namada-indexer.git
cd namada-indexer
git checkout v4.1.0

Step 2: Configure Environment Variables

cp .env.sample .env
nano .env

Edit .env file:

# PostgreSQL Configuration
POSTGRES_PASSWORD=YOUR_STRONG_PASSWORD_HERE
DATABASE_URL=postgres://namada:YOUR_STRONG_PASSWORD_HERE@postgres:5432/namada-indexer
DATABASE_URL_TEST=postgres://namada:YOUR_STRONG_PASSWORD_HERE@postgres:5432/namada-indexer

# RPC Configuration (use external RPC endpoint)
TENDERMINT_URL=https://housefire.rpc.yourdomain.com

# Cache Configuration
CACHE_URL=redis://dragonfly:6379

# Webserver Configuration
WEBSERVER_PORT=5001
WEBSERVER_HOST_IP=0.0.0.0

Generate strong password:

openssl rand -base64 32

Step 3: Verify Docker Compose Configuration

grep -A 8 "postgres:" docker-compose.yml | grep -A 8 "image:"

Should show:

postgres:
  image: postgres:16-alpine
  command: [ "postgres", "-c", "max_connections=200" ]
  expose:
    - "5432"
  environment:
    POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?}

Step 4: Verify CometBFT RPC Access

cat ~/.local/share/namada/*/cometbft/config/config.toml | grep -A 2 "\[rpc\]"

Should show:

[rpc]
laddr = "tcp://0.0.0.0:26657"

Step 5: Build and Start Services

cd /var/www/namada-indexer
docker-compose build --no-cache
docker-compose up -d

Step 6: Verify Installation

# Check all containers are running
docker-compose ps

# Expected services (all should be "Up"):
# - namada-indexer-chain-1
# - namada-indexer-dragonfly-1 (healthy)
# - namada-indexer-governance-1
# - namada-indexer-parameters-1
# - namada-indexer-pos-1
# - namada-indexer-postgres-1 (healthy)
# - namada-indexer-rewards-1
# - namada-indexer-transactions-1
# - namada-indexer-webserver-1 (healthy)

# Check health endpoint
curl http://localhost:5001/health

# Expected output:
# {"status":"ok","version":"3.3.4"}

# Check latest block
curl -s http://localhost:5001/api/v1/chain/block/latest | jq -r '.block'

Step 7: Check Logs

# View all logs
docker-compose logs -f --tail=50

# Check specific services
docker logs namada-indexer-webserver-1 --tail=50
docker logs namada-indexer-chain-1 --tail=50
docker logs namada-indexer-postgres-1 --tail=50

✅ Upgrade Indexer from v3.x.x to v4.1.0

Step 1: Backup Current Setup

cd /var/www/namada-indexer

# Stop all services
docker-compose down

# Backup .env file
cp .env .env.backup

# Backup entire directory (optional)
cd /var/www/
cp -r namada-indexer namada-indexer-backup

Step 2: Update

cd /var/www/namada-indexer
git fetch --all --tags
git checkout v4.1.0
git describe --tags

Step 3: Rebuild and Restart

docker-compose build --no-cache
docker-compose up -d

Step 4: Verify

curl -s http://localhost:5001/health | jq -r '.version'
# Expected: v4.1.0

# Check logs for errors
docker-compose logs -f --tail=100

Step 5: Verify API Health

curl http://localhost:5001/health
curl https://yourdomain.com/indexer/health

✅ Database Backup & Restore

Data Persistence

Data location:

/var/lib/docker/volumes/namada-indexer_postgres-data/_data

Verify volume:

docker volume ls | grep postgres-data
docker volume inspect namada-indexer_postgres-data

Data Safety Rules

Data is SAFE during:

• ✅ docker-compose down

• ✅ docker-compose restart

• ✅ docker-compose build --no-cache

• ✅ Version upgrades

Data is DELETED when:

• ❌ docker-compose down --volumes

• ❌ docker volume rm namada-indexer_postgres-data

Golden Rule: NEVER use --volumes flag!

Manual Backup

mkdir -p /var/backups/namada-indexer

docker run --rm \
  -v namada-indexer_postgres-data:/data \
  -v /var/backups/namada-indexer:/backup \
  alpine tar czf /backup/postgres-backup-$(date +%Y%m%d-%H%M%S).tar.gz -C /data .

ls -lh /var/backups/namada-indexer/

Manual Restore

cd /var/www/namada-indexer
docker-compose down

docker run --rm \
  -v namada-indexer_postgres-data:/data \
  -v /var/backups/namada-indexer:/backup \
  alpine sh -c "cd /data && tar xzf /backup/postgres-backup-YYYYMMDD-HHMMSS.tar.gz"

docker-compose up -d

✅ Troubleshooting

Quick Commands

# Restart services
docker-compose restart

# Check logs
docker-compose logs -f

# Health check
curl http://localhost:5001/health

# Check block height
curl -s http://localhost:5001/api/v1/chain/block/latest | jq -r '.block'

Full Reset (Destroys Data!)

cd /var/www/namada-indexer
docker-compose down --volumes  # DELETES ALL DATA!
docker volume prune -f
docker-compose up -d --build

Safe Restart

docker-compose down
docker-compose build --no-cache
docker-compose up -d

✅ Monitoring

# Health status
curl -sf http://localhost:5001/health && echo "✅ Healthy" || echo "❌ Unhealthy"

# Block height
curl -s http://localhost:5001/api/v1/chain/block/latest | jq -r '.block'

# Version
curl -s http://localhost:5001/health | jq -r '.version'

# Container stats
docker stats --no-stream

✅ API Documentation

Full docs: https://anoma.github.io/namada-indexer/

Endpoints:

• /health - Health check

• /api/v1/chain/block/latest - Latest block

• /api/v1/pos/validator/all - All validators

• /api/v1/gov/proposal/all - Governance proposals

✅ Integration with Namadillo

nano /var/www/namadillo/apps/namadillo/public/config.toml

Add:

indexer_url = "https://housefire.indexer.yourdomain.com"
rpc_url = "https://housefire.rpc.yourdomain.com"
masp_indexer_url = "https://housefire.masp-indexer.yourdomain.com"
localnet_enabled = false