Installation

Installation Guide

This guide covers all installation options for PoCX Wallet.

Prerequisites

Required Software

Software	Version	Purpose
.NET SDK	9.0+	Build and run the application
Docker	Latest	Run services (node, miner, plotter)
Git	Latest	Clone the repository

System Requirements

Resource	Minimum	Recommended
RAM	4 GB	8 GB+
Storage	10 GB	100 GB+ (for blockchain)
CPU	2 cores	4+ cores

Installation Steps

1. Install .NET SDK

Linux (Ubuntu/Debian)

# Add Microsoft package repository
wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

# Install .NET SDK
sudo apt-get update
sudo apt-get install -y dotnet-sdk-9.0

macOS

# Using Homebrew
brew install dotnet-sdk

# Or download from https://dotnet.microsoft.com/download

Windows

Download and install from https://dotnet.microsoft.com/download

2. Install Docker

Linux

# Quick install script
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# Add your user to docker group (avoids sudo)
sudo usermod -aG docker $USER
newgrp docker

macOS / Windows

Download and install Docker Desktop

3. Clone the Repository

git clone https://github.com/ev1ls33d/pocx-wallet.git
cd pocx-wallet

4. Build the Application

dotnet build

Expected output:

Build succeeded.
    0 Warning(s)
    0 Error(s)

5. Run the Application

cd PocxWallet.Cli
dotnet run

You should see the main menu:

─────────────────────────────────────────
 PoCX HD Wallet
─────────────────────────────────────────

> [Wallet]         Wallet Management
  [Node]           Bitcoin-PoCX Node      ●
  [Plot]           PoCX Plotter           ●
  [Mine]           PoCX Miner             ●
  [Aggregator]     PoCX Aggregator        ●
  [Electrs]        Electrs Server         ●
  [Exit]           Exit

Docker Images

The wallet uses pre-built Docker images from GitHub Container Registry:

Image	Description
ghcr.io/ev1ls33d/pocx-wallet/bitcoin:latest	Bitcoin-PoCX node
ghcr.io/ev1ls33d/pocx-wallet/electrs:latest	Electrum server
ghcr.io/ev1ls33d/pocx-wallet/pocx:latest	Plotter, Miner, Aggregator

Images are automatically pulled when you start a service for the first time.

Manual Image Pull

To pre-download images:

docker pull ghcr.io/ev1ls33d/pocx-wallet/bitcoin:latest
docker pull ghcr.io/ev1ls33d/pocx-wallet/electrs:latest
docker pull ghcr.io/ev1ls33d/pocx-wallet/pocx:latest

Verifying Installation

Check .NET Version

dotnet --version
# Should output: 9.0.x or higher

Check Docker

docker --version
# Should output: Docker version 2x.x.x or higher

docker run hello-world
# Should complete successfully

Test Build

cd /path/to/pocx-wallet
dotnet build
dotnet test  # Optional: run tests

Troubleshooting

.NET SDK Not Found

The command 'dotnet' was not found

Solution: Ensure .NET SDK is installed and in your PATH. Try logging out and back in.

Docker Permission Denied

Got permission denied while trying to connect to the Docker daemon socket

Solution:

sudo usermod -aG docker $USER
newgrp docker
# Or log out and back in

Docker Not Running

Cannot connect to the Docker daemon

Solution: Start Docker Desktop (Windows/macOS) or sudo systemctl start docker (Linux)

Build Errors

error CS0234: The type or namespace name 'X' does not exist

Solution:

dotnet restore
dotnet build

Next Steps

After installation:

1. Read the Wallet Management Guide to create your first wallet
2. Check the Services Guide to understand Docker services
3. Review the Configuration Guide for customization options

---

← Back to Home