From f468b7ea1ff28b054f54ff25a5a22909a325b5f0 Mon Sep 17 00:00:00 2001 From: Vijit Singh Date: Fri, 12 Jun 2026 17:44:20 -0500 Subject: [PATCH 1/3] Profile README: lead with P2Pool Starter Stack, refresh for v1.0 Make the org profile consistent with the rebrand and the current state of both projects. - Lead with the org name, P2Pool Starter Stack. - RigForge: add macOS support, the measured benchmark (+3.5% hashrate / +7.6% efficiency on a 7800X3D, +6.6% on a 48-core EPYC), and commit-pinned stock XMRig. - Pithead: sharpen features to the current README (donate-minimum XvB optimizer, honest tier + VIP status, scoped Docker-socket proxies). - Privacy ethos made precise: inbound is Tor-only via hidden services; the remaining v1.0 clearnet egress is documented and goes Tor-by-default in v1.1 (was overstated as "Tor-only upstreams"). - Note both projects are at v1.0. Co-Authored-By: Claude Opus 4.8 (1M context) --- profile/README.md | 40 ++++++++++++++++++++++------------------ 1 file changed, 22 insertions(+), 18 deletions(-) diff --git a/profile/README.md b/profile/README.md index 7cd14d0..d2f863f 100644 --- a/profile/README.md +++ b/profile/README.md @@ -1,4 +1,6 @@ -# Private Monero mining, self-hosted โ€” the whole operation ๐Ÿง…โ›๏ธ +# P2Pool Starter Stack + +### Private, self-hosted Monero + Tari mining โ€” the whole operation. ๐Ÿง…โ›๏ธ > An **orchestrator** and the **miners** that feed it. Two open-source projects for running a > private, optimized **Monero + Tari** mining operation on hardware you own โ€” no custodians, no @@ -13,24 +15,24 @@ A professional-grade, containerized stack that runs a private Monero full node, **P2Pool**, **Tari** merge mining, a single mining endpoint, and a live dashboard โ€” all behind **Tor**, in one command. -- ๐Ÿง… **Private by default** โ€” Tor hidden services for Monero, Tari, and P2Pool; no port forwarding, no exposed IP. -- โ›๏ธ **Monero + Tari, merge-mined** โ€” earn on both chains at once, with zero extra effort. -- ๐Ÿง  **Algorithmic yield optimization** โ€” continuously splits your hashrate between P2Pool and XMRvsBeast bonus rounds to maximize return. -- ๐Ÿ”Œ **One endpoint for every rig** โ€” all your miners point at a single address; the stack routes hashrate upstream. -- ๐Ÿ“Š **A dashboard that actually tells you things** โ€” live hashrate, sync progress, PPLNS window, and per-worker stats, served over HTTPS on your LAN. -- ๐Ÿ”’ **Hardened out of the box** โ€” least-privilege containers, SHA256-verified pinned binaries, and tightly scoped Docker-socket proxies. +- ๐Ÿง… **Private by default** โ€” Tor hidden services for Monero, Tari, and P2Pool; your router stays shut and your home IP is never advertised to an inbound peer. +- โ›๏ธ **Monero + Tari, merge-mined** โ€” every hash mines Monero on zero-fee P2Pool and merge-mines Tari at once: a second payout for zero extra power or config. +- ๐Ÿง  **Algorithmic yield optimization** โ€” watches the XMRvsBeast raffle and shifts hashrate to grab bonus rounds, donating only the minimum to hold your tier, then handing every spare cycle back to your own P2Pool payouts. +- ๐Ÿ”Œ **One endpoint for every rig** โ€” all your miners point at a single address; no wallet in the miner, no per-rig pool config. +- ๐Ÿ“Š **A dashboard worth leaving open** โ€” live hashrate, the P2Pool/XvB split shading in real time, the PPLNS window, an honest tier + explicit VIP status, and per-worker stats, served over HTTPS on your LAN. +- ๐Ÿ”’ **Hardened out of the box** โ€” least-privilege containers, SHA256-verified pinned binaries, and tightly scoped Docker-socket proxies (read-only for stats, start/stop-only for failover). ### ๐Ÿ”ฅ [RigForge](https://github.com/p2pool-starter-stack/rigforge) โ€” the miners -Turn any machine into a tuned mining worker in one command. RigForge builds stock **XMRig** from -source, applies CPU- and kernel-level tuning for maximum RandomX hashrate, and runs it as a managed -service โ€” then points it at your stack. +Turn any Ubuntu/Debian โ€” or macOS โ€” machine into a tuned mining worker in one command. RigForge +compiles stock, commit-pinned **XMRig** from source, applies CPU- and kernel-level tuning for maximum +RandomX hashrate, and runs it as a managed service โ€” then points it at your stack, or any RandomX pool. -- โšก **One command** from bare metal to a running, tuned miner. -- ๐Ÿง  **Hardware-aware** โ€” detects your CPU (AMD EPYC, Ryzen X3D, โ€ฆ) and applies a matching performance profile. -- โš™๏ธ **Kernel-tuned** โ€” HugePages (1 GB / 2 MB), MSR access, and NUMA binding, done for you. -- ๐Ÿ”ง **Managed** โ€” runs as a `systemd` service with a performance governor and automatic log rotation. -- ๐Ÿ”— **Plug-and-play** โ€” connects to Pithead, or any RandomX Stratum pool. +- โšก **One command** from bare metal to a running, tuned miner โ€” on Ubuntu/Debian or macOS. +- ๐Ÿ“ˆ **Measurably faster, and cooler** โ€” +3.5% hashrate and +7.6% efficiency on a Ryzen 7800X3D, measured live against stock XMRig (and +6.6% on a 48-core EPYC). +- ๐Ÿง  **Hardware-aware** โ€” detects your CPU (AMD EPYC, Ryzen X3D, โ€ฆ), applies a matching profile, then live-A/Bs the hardware prefetcher to keep the fastest. +- โš™๏ธ **Kernel-tuned (Linux)** โ€” HugePages (1 GB / 2 MB), MSR access, NUMA binding, and a performance governor, done for you. +- ๐Ÿ”— **Plug-and-play** โ€” connects to Pithead, or any RandomX Stratum pool. Stock XMRig pinned to a verified commit โ€” no custom binary, idempotent re-runs. ### ๐Ÿ”— How they fit together @@ -50,8 +52,9 @@ privacy, payouts, and optimization; the miners just hash. A few principles you'll see throughout the code: -- **Privacy is the default, not a setting.** Tor-only upstreams, localhost-bound RPC, and no public - port forwarding. You opt *out* of privacy โ€” never *in*. +- **Privacy is the default, not a setting.** Inbound rides Tor hidden services โ€” no port forwarding, + your home IP never advertised to a peer โ€” and RPC is localhost-bound. The few outbound paths that + still touch clearnet in v1.0 are mapped in the privacy guide and move to Tor-by-default in v1.1. - **Least privilege, everywhere.** Capability-scoped containers, a read-only Docker-socket proxy kept separate from a start/stop-only one, owner-only secrets. Nothing gets more access than it needs. @@ -72,4 +75,5 @@ A few principles you'll see throughout the code: - **New to this?** โ†’ [**Pithead**](https://github.com/p2pool-starter-stack/pithead) gets the whole operation running in one command. - **Already have the stack?** โ†’ [**RigForge**](https://github.com/p2pool-starter-stack/rigforge) provisions your miners. -Everything here is **MIT-licensed** and built in the open. Issues and pull requests are welcome. +Both projects are at their **v1.0** โ€” RigForge complete, Pithead feature-complete and through its +release gate. Everything here is **MIT-licensed** and built in the open. Issues and pull requests are welcome. From c5b582b37adfb8e99e63477675a973551fab2433 Mon Sep 17 00:00:00 2001 From: Vijit Singh Date: Sun, 14 Jun 2026 00:53:56 -0500 Subject: [PATCH 2/3] Profile README: add site link, quick-facts, and an FAQ for launch discoverability MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Builds on the rebrand so the org profile is launch-ready and quotable when AI assistants and search surface it for "how to mine Monero privately" queries. - Link to the live site (p2pool-starter-stack.github.io) up top and in "Start here" โ€” it was missing entirely. - Keyword-rich, quotable intro ("Mine Monero privately, on hardware you own") plus a one-line trust band: free & MIT ยท no token ยท no premine ยท no VC ยท Tor-first. - New "Common questions" FAQ (6 Qs) mirroring the site: mining Monero at home, ports/IP, P2Pool vs centralized pools, fees, reusing existing rigs, hardware. GitHub READMEs are heavily crawled and cited by LLMs, so this is high-leverage. - 0% dev-fee added to the RigForge bullets, consistent with the site copy. Keeps the existing projects / how-we-build / mermaid sections; stays consistent with the showcase-site PR. Co-Authored-By: Claude Opus 4.8 (1M context) --- profile/README.md | 50 ++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 45 insertions(+), 5 deletions(-) diff --git a/profile/README.md b/profile/README.md index d2f863f..7af2b08 100644 --- a/profile/README.md +++ b/profile/README.md @@ -1,10 +1,14 @@ # P2Pool Starter Stack -### Private, self-hosted Monero + Tari mining โ€” the whole operation. ๐Ÿง…โ›๏ธ +### Mine Monero privately, on hardware you own โ€” the whole operation, in one command. ๐Ÿง…โ›๏ธ -> An **orchestrator** and the **miners** that feed it. Two open-source projects for running a -> private, optimized **Monero + Tari** mining operation on hardware you own โ€” no custodians, no -> exposed home IP, no hand-tuning. +> Two open-source projects for running a **private, optimized Monero + Tari mining operation** at +> home: an **orchestrator** ([Pithead](https://github.com/p2pool-starter-stack/pithead)) and the +> **miners** that feed it ([RigForge](https://github.com/p2pool-starter-stack/rigforge)). Decentralized, +> **zero-fee P2Pool** payouts straight to your own wallet, all behind **Tor** โ€” no custodians, no +> exposed home IP, no pool fees, no hand-tuning. + +**๐ŸŒ [p2pool-starter-stack.github.io](https://p2pool-starter-stack.github.io/)** ยท free & MIT ยท no token ยท no premine ยท no VC ยท Tor-first --- @@ -32,7 +36,7 @@ RandomX hashrate, and runs it as a managed service โ€” then points it at your st - ๐Ÿ“ˆ **Measurably faster, and cooler** โ€” +3.5% hashrate and +7.6% efficiency on a Ryzen 7800X3D, measured live against stock XMRig (and +6.6% on a 48-core EPYC). - ๐Ÿง  **Hardware-aware** โ€” detects your CPU (AMD EPYC, Ryzen X3D, โ€ฆ), applies a matching profile, then live-A/Bs the hardware prefetcher to keep the fastest. - โš™๏ธ **Kernel-tuned (Linux)** โ€” HugePages (1 GB / 2 MB), MSR access, NUMA binding, and a performance governor, done for you. -- ๐Ÿ”— **Plug-and-play** โ€” connects to Pithead, or any RandomX Stratum pool. Stock XMRig pinned to a verified commit โ€” no custom binary, idempotent re-runs. +- ๐Ÿ”— **Plug-and-play** โ€” connects to Pithead, or any RandomX Stratum pool. Stock XMRig pinned to a verified commit โ€” no custom binary, a 0% dev fee, idempotent re-runs. ### ๐Ÿ”— How they fit together @@ -48,6 +52,41 @@ privacy, payouts, and optimization; the miners just hash. --- +## โ“ Common questions + +**How do I mine Monero privately at home?** +Run the P2Pool Starter Stack. One command stands up a private Monero full node, P2Pool, and a single +mining endpoint behind Tor โ€” your home IP is never advertised to an inbound peer and you never forward +a port. Point any XMRig rig (or a RigForge worker) at it and you're mining straight to your own wallet, +no account and no custodian. + +**Do I have to forward ports or expose my home IP?** +No. Monero, Tari, and P2Pool run as Tor hidden services, so inbound peers reach you over an onion +address and your router stays shut; RPC is localhost-bound. The few outbound yield paths still on +clearnet in v1.0 are mapped in the privacy guide and move to Tor-by-default in v1.1. + +**What is P2Pool, and why mine to it instead of a centralized pool?** +P2Pool is a decentralized, peer-to-peer Monero mining pool: no operator, no account, and no pool fee โ€” +the network pays block rewards straight to your own wallet. The stack runs your own P2Pool node, so you +get decentralized, zero-fee payouts without the fiddly setup. + +**Is it free? Are there any fees?** +Yes โ€” free and MIT-licensed. P2Pool charges no pool fee, and RigForge compiles stock XMRig with the +dev-fee pinned to 0%. No token, no premine, no VC โ€” just an optional Monero donation if a stack saves +you time. + +**Can I point my existing XMRig miners at it?** +Yes โ€” point any XMRig or RandomX rig at the stack's single endpoint (`host:3333`), no wallet in the +miner. For maximum hashrate, RigForge provisions a kernel-tuned XMRig worker in one command +(+3.5% hashrate / +7.6% efficiency on a Ryzen 7800X3D vs stock). + +**What hardware do I need?** +Stack host: Ubuntu Server 24.04, 16 GB+ RAM, an SSD (~300 GB pruned; 2โ€“4 TB for set-and-forget). +Mining itself is CPU-bound โ€” Monero's RandomX runs on any modern AMD/Intel CPU, and large-L3 chips +(Ryzen X3D, EPYC) shine. RigForge tunes per-CPU automatically. + +--- + ## ๐Ÿ› ๏ธ How we build A few principles you'll see throughout the code: @@ -74,6 +113,7 @@ A few principles you'll see throughout the code: - **New to this?** โ†’ [**Pithead**](https://github.com/p2pool-starter-stack/pithead) gets the whole operation running in one command. - **Already have the stack?** โ†’ [**RigForge**](https://github.com/p2pool-starter-stack/rigforge) provisions your miners. +- **Want the overview?** โ†’ [**p2pool-starter-stack.github.io**](https://p2pool-starter-stack.github.io/) Both projects are at their **v1.0** โ€” RigForge complete, Pithead feature-complete and through its release gate. Everything here is **MIT-licensed** and built in the open. Issues and pull requests are welcome. From 8c7e4c64fd145b41957ece96dfaffa446a7936d0 Mon Sep 17 00:00:00 2001 From: Vijit Singh Date: Sun, 14 Jun 2026 01:49:44 -0500 Subject: [PATCH 3/3] Profile README: add live latest-release badges for Pithead + RigForge MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Shows each project's current release tag (now v1.0.2 / v1.0.1) right under the tagline, via shields.io's github/v/release endpoint โ€” re-queried on every render, so they always reflect the newest release with no manual bumping. Brand-coloured (Pithead orange, RigForge ember) and linked to each repo's releases/latest, plus an MIT badge. Mirrors the build-time version badges on the showcase site. Co-Authored-By: Claude Opus 4.8 (1M context) --- profile/README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/profile/README.md b/profile/README.md index 7af2b08..157910f 100644 --- a/profile/README.md +++ b/profile/README.md @@ -2,6 +2,10 @@ ### Mine Monero privately, on hardware you own โ€” the whole operation, in one command. ๐Ÿง…โ›๏ธ +[![Pithead release](https://img.shields.io/github/v/release/p2pool-starter-stack/pithead?sort=semver&display_name=tag&label=Pithead&color=F26822&logo=github)](https://github.com/p2pool-starter-stack/pithead/releases/latest) +[![RigForge release](https://img.shields.io/github/v/release/p2pool-starter-stack/rigforge?sort=semver&display_name=tag&label=RigForge&color=ff5236&logo=github)](https://github.com/p2pool-starter-stack/rigforge/releases/latest) +[![License: MIT](https://img.shields.io/badge/license-MIT-yellow)](https://github.com/p2pool-starter-stack) + > Two open-source projects for running a **private, optimized Monero + Tari mining operation** at > home: an **orchestrator** ([Pithead](https://github.com/p2pool-starter-stack/pithead)) and the > **miners** that feed it ([RigForge](https://github.com/p2pool-starter-stack/rigforge)). Decentralized,