pezkuwichain/pezkuwi-validator-v1.0.0

mirror of https://github.com/pezkuwichain/pezkuwi-validator-v1.0.0.git synced 2026-04-24 18:27:56 +00:00

Files

T

pezkuwichain a5532af65f feat: Add Docker-based validator setup

- Created Dockerfile with multi-stage build
- Added docker-compose.yml with validator service
- Integrated Prometheus and Grafana monitoring (optional)
- Health checks and automatic restarts
- Volume management for data persistence
- Comprehensive Docker README with troubleshooting
- Updated main README with Docker instructions

Docker setup features:
- One-command deployment
- Auto-restart on failure
- Built-in monitoring stack
- Production-ready configuration
- Easy backup and restore

2025-10-27 21:25:13 +03:00

2.7 KiB

Raw Blame History

Pezkuwi Validator - Docker Setup

Run Pezkuwi validator node using Docker and Docker Compose.

🚀 Quick Start

Prerequisites

Docker 20.10+
Docker Compose 2.0+

Install Docker:

# Linux
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

# Verify
docker --version
docker-compose --version

Run Validator

# Clone repository
git clone https://github.com/pezkuwichain/pezkuwi-validator-v1.0.0.git
cd pezkuwi-validator-v1.0.0/docker

# Start validator
docker-compose up -d

# Check logs
docker-compose logs -f pezkuwi-validator

# Check status
docker-compose ps

📊 Monitoring (Optional)

Start with Prometheus and Grafana:

docker-compose --profile monitoring up -d

Access:

Prometheus: http://localhost:9090
Grafana: http://localhost:3000 (admin/pezkuwi123)

🔧 Management Commands

# Stop validator
docker-compose stop

# Restart validator
docker-compose restart

# View logs
docker-compose logs -f

# Remove everything (including data)
docker-compose down -v

# Update to latest version
docker-compose pull
docker-compose up -d

📁 Data Persistence

Blockchain data is stored in Docker volume: validator-data

Backup data:

docker run --rm -v validator-data:/data -v $(pwd):/backup ubuntu tar czf /backup/validator-backup.tar.gz /data

Restore data:

docker run --rm -v validator-data:/data -v $(pwd):/backup ubuntu tar xzf /backup/validator-backup.tar.gz -C /

🔑 Validator Keys

Keys are generated automatically on first start in /pezkuwi/data/chains/

Extract your Node ID:

docker-compose exec pezkuwi-validator cat /pezkuwi/data/chains/pezkuwi_testnet/network/secret_ed25519

🌐 Network Ports

30333: P2P port (required for validators)
9944: RPC/WebSocket (for local access)
9615: Prometheus metrics

🐛 Troubleshooting

Container won't start

# Check logs
docker-compose logs pezkuwi-validator

# Rebuild image
docker-compose build --no-cache
docker-compose up -d

Out of disk space

# Check disk usage
docker system df

# Prune unused data
docker system prune -a

Performance issues

# Check resource usage
docker stats pezkuwi-validator

# Increase resources in Docker Desktop settings

🔄 Updates

# Pull latest image
docker-compose pull

# Restart with new image
docker-compose up -d

📝 Custom Configuration

Edit docker-compose.yml to customize:

Node name
Ports
Resource limits
Logging options

Example resource limits:

services:
  pezkuwi-validator:
    # ... other config
    deploy:
      resources:
        limits:
          cpus: '2'
          memory: 4G
        reservations:
          cpus: '1'
          memory: 2G

2.7 KiB Raw Blame History