IGRA Orchestra

A Docker Compose-based deployment environment for IGRA Orchestra components.

Getting Started

Choose your deployment guide:

• Mainnet - Public mainnet deployment with pre-built images
• Galleon Testnet - Public Galleon testnet deployment with pre-built images

Operations

• Node Operations - Worker config, wallet API, balance monitoring, health checks, ATAN-only mode, and external CPU mining
• Reth Upgrade: 1.9.3 → 2.5.1 - Drop the execution-layer database and resync when RETH_VERSION moves to the 2.5.1-igra.1 line; kaspad data is preserved (12+ hours, L2 RPC offline)
• Kaspa Wallet Guide - Wallet setup and management for all networks
• Log Management - Automated log cleanup for servers

Troubleshooting

• Docker Volume Permissions - Fix permission denied errors
• Kaspad DB Upgrade Prompt - Run the one-time noninteractive kaspad DB metadata upgrade
• Service Restart Debugging - Diagnose fail-fast exits, restart loops, and Docker log persistence
• SSL Certificate Issues - Fix Traefik certificate resolver errors

Requirements

• Docker Engine 23.0+ and Docker Compose V2+
• At least 32GB RAM (recommended for production)
• Git and SSH access to github.com

Quick Start

For the fastest setup, use the automated scripts:

# IGRA Mainnet
./scripts/setup-mainnet.sh

# Galleon Testnet
./scripts/setup-galleon-testnet.sh

For full details, see the README on GitHub.