# ⛏️ 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)*