Initial Release: Custom Bitcoin Solo Pool Stack

2026-08-24 11:39:33 +02:00
commit 2b7fa5396a
4 changed files with 245 additions and 0 deletions
@@ -0,0 +1,41 @@
+# ⛏️ Bitcoin Solo-Pool & Custom Dashboard Stack
+
+Ein autarkes, ressourcenschonendes Bitcoin Solo-Mining-Setup via Docker. 
+Beinhaltet eine eigene **Bitcoin Full Node (bitcoind)**, das **public-pool Backend (NestJS)** für Stratum-Verbindungen und ein **maßgeschneidertes, performantes PHP/JS-Dashboard** als Frontend[cite: 2].
+
+## 🚀 Warum dieser Stack?
+Das Standard-Frontend (`public-pool-ui`) belegt oft unnötig Arbeitsspeicher und verursacht bei externen Abfragen CORS-Probleme[cite: 2]. Dieses Setup ersetzt das Frontend durch ein schlankes PHP-Dashboard. Es fungiert als API-Proxy, loggt die Hashrate-Historie in eine lokale JSON und bietet 24/7 Graphen (Chart.js)[cite: 2].
+
+## ⚙️ Installation
+
+1. Repository klonen:
+```bash
+git clone [https://github.com/tessmania90/bitcoin-solo-pool.git](https://github.com/tessmania90/bitcoin-solo-pool.git)
+cd bitcoin-solo-pool
+```
+
+2. Stack starten:
+```bash
+docker compose up -d
+```
+
+### ⚠️ Wichtige Hinweise zum Sync
+* **Initial Block Download (IBD):** Die Bitcoin-Node muss beim ersten Start synchronisieren (kann >24h dauern)[cite: 2].
+* Solange der Sync nicht zu 100% fertig ist, verweigert die Node Block-Templates. Das `public-pool` Backend wirft in dieser Zeit Verbindungsfehler[cite: 2]. **Bitte warten, bis der Sync fertig ist!**
+* **Speicherplatz:** Die Node startet mit `-prune=5000` und verbraucht so nur ca. 17 GB statt >650 GB[cite: 2].
+
+## 📊 Dashboard & Graphen-Aufzeichnung
+Das Dashboard ist unter `http://<DEINE-IP>:8080` erreichbar.
+
+Damit die Hashrate-Historie lückenlos alle 5 Minuten aufgezeichnet wird, richte einen Cronjob auf dem Docker-Host ein (oder nutze Uptime Kuma)[cite: 2]:
+```bash
+*/5 * * * * curl -s "[http://127.0.0.1:8080/?api_action=pool](http://127.0.0.1:8080/?api_action=pool)" > /dev/null
+```
+
+## 🔌 Miner verbinden (z.B. Bitaxe, NerdMiner)
+* **Stratum URL:** `stratum+tcp://<DEINE-IP>:21496`[cite: 2]
+* **User/Worker:** `<DeineBitcoinAdresse>.<WorkerName>`[cite: 2]
+* **Passwort:** `x`[cite: 2]
+
+---
+*Ein Projekt von [tessmann.dev](https://tessmann.dev)*