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 dashboard.

For detailed mining configuration, see Mining Guide. For pool setup, see Pool Setup.