chesterk/solana-test-validator repository overview

⁠Solana Test Validator

A ready-to-use Docker image for running a Solana test validator with pre-funded test accounts. Built from source to support ARM64/Apple Silicon architectures.

⁠Quick Start

docker run -d \
  -p 8899:8899 \
  -p 8900:8900 \
  -p 9900:9900 \
  --name solana-validator \
  chesterk/solana-test-validator

⁠Features

• ✅ ARM64 & AMD64 Support - Works on Apple Silicon (M1/M2/M3) and Intel/AMD processors
• 💰 Pre-configured Faucet - Request up to 1000 SOL for testing
• 🚀 Built from Source - Latest Solana codebase compiled directly
• 🔄 Auto-reset - Starts with clean state on each restart
• 📦 Multi-stage Build - Optimized image size (~200-300 MB)

⁠Ports

⁠Usage

⁠Connect to the Validator

solana config set --url http://localhost:8899

⁠Request an Airdrop

# Using Solana CLI
solana airdrop 1

# Using curl
curl -X POST http://localhost:9900/airdrop/<PUBKEY>/1000000000

⁠Check Balance

solana balance

⁠Docker Compose

version: '3.8'
services:
  solana-test-validator:
    image: your-dockerhub-username/solana-test-validator
    ports:
      - "8899:8899"
      - "8900:8900"
      - "9900:9900"
    volumes:
      - solana-ledger:/solana/ledger
volumes:
  solana-ledger:

⁠Why Built from Source?

Official Solana releases don't provide ARM64 binaries. This image compiles Solana from the official GitHub repository to ensure compatibility across all architectures. Furthermore, solanalabs GitHub repositories are all archived, now. They announced to move to Anza but it's not the same and straightforward to migrate. While solana-test-validator is still useful, there's no hope to expect the official image from them, anymore.

⁠Links

• 📖 GitHub Repository⁠
• 📚 Solana Documentation⁠
• 🐛 Report Issues⁠

⁠Tags

• latest - Latest stable build

⁠License

MIT License - See LICENSE⁠ for details