Setup Guide

System requirements, installation, node configuration, and wallet setup for ZION TestNet.

System Requirements

• CPU: 2+ cores (4+ recommended for RandomX mining)
• RAM: 8 GB (16 GB recommended)
• Storage: 20 GB free (SSD recommended)
• Network: Stable broadband connection
• OS: Windows, Linux, or macOS

Installation

Windows

1. Download the latest TestNet release (ZIP) from GitHub Releases.
2. Extract and open a terminal in the folder.
3. Run:
   zion-node.exe --testnet --rpc-port 8545

Linux

1. Download tarball from Releases.
2. Extract and mark binaries executable:
   chmod +x zion-node zion-miner
3. Run:
   ./zion-node --testnet --rpc-port 8545

macOS

1. Download tarball from Releases.
2. If blocked by Gatekeeper, allow in System Settings → Privacy & Security.
3. Run:
   ./zion-node --testnet --rpc-port 8545

Node Configuration

Create a config file (optional) or pass flags via CLI. Example minimal config:

{
  "network": "testnet",
  "rpc": { 
    "enabled": true, 
    "port": 8545 
  }
}

Wallet Setup

1. Create a new wallet and securely store the seed phrase.
2. Connect your miner to the wallet address.
3. Test sending a small transaction on testnet.

Next Steps

• Read the Mining Guide.
• Explore the API Reference.
• View Live Stats on the homepage.