Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Quick Start

Get up and running with the guided installer.

One-Line Install

curl -sSL https://raw.githubusercontent.com/PoC-Consortium/bitcoin-pocx-docs/main/scripts/install.sh | bash

Or download and review first:

curl -LO https://raw.githubusercontent.com/PoC-Consortium/bitcoin-pocx-docs/main/scripts/install.sh
less install.sh  # review the script
bash install.sh

What the Installer Does

The guided installer will:

  1. Detect your OS (Debian/Ubuntu, Fedora, Arch)
  2. Install dependencies (curl, tar, etc.)
  3. Ask your role:
    • Node Operator (network support only)
    • Solo Miner (mine to your own wallet)
    • Pool Miner (mine through a pool)
  4. Download latest releases from GitHub
  5. Configure based on your choices:
    • Testnet or Mainnet
    • Create dedicated bitcoin user (optional)
    • Install systemd services (optional)
  6. Start services and verify

Installer Options

# Interactive mode (default)
bash install.sh

# Specify role directly
bash install.sh --role node-operator
bash install.sh --role solo-miner
bash install.sh --role pool-miner

# Specify network
bash install.sh --testnet
bash install.sh --mainnet

# Non-interactive with defaults
bash install.sh --role solo-miner --testnet --yes

Manual Installation

Prefer to do it yourself? See the manual guides: