satoshi/KamadoPool-StartOS-0351
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Tidy config: drop payout-address field, group niche options under Advanced

Browse Source 
Worker stratum username is the payout address in ckpool-solo, so the
separate field was redundant. Niche vardiff/logging/zmq knobs now
live under an Advanced group with sensible defaults.
This commit is contained in:
satoshi
2026-04-14 17:10:51 +03:00
parent cb739867cc
commit a63e7256c4
3 changed files with 101 additions and 95 deletions
Download Patch File Download Diff File Expand all files Collapse all files
instructions.md
+4 -4
View File
@@ -5,9 +5,9 @@ Kamado is a solo Bitcoin mining pool built on a patched fork of CKPool-solo, wit
## Setup
1. Install Bitcoin Core (mainnet) **or** Bitcoin Core (testnet4). Kamado supports either as a dependency; pick one in the Kamado config under *Bitcoin Core > Type*.
2. In the Kamado config, set **Payout Address** to the Bitcoin address that should receive solved block rewards.
3. Optionally adjust the **Coinbase Tag** (default `/Kamado/`) and the vardiff parameters.
4. Start Kamado. Open the web UI from the Services page to watch live hashrate, miners, best shares, and solved blocks.
2. Start Kamado. Open the web UI from the Services page to watch live hashrate, miners, best shares, and solved blocks.
There is no payout address field. CKPool-solo pays the full block reward directly to whichever Bitcoin address the miner connects with as its stratum username — see **Connecting miners** below. Kamado validates worker usernames against Bitcoin Core and **refuses to authenticate any worker whose username is not a valid address on the active network**, so misconfigured miners fail loudly instead of silently mining to the wrong place.
## Connecting miners
@@ -20,7 +20,7 @@ Because the cert is self-signed, miners must connect with certificate verificati
- **Router port-forward**: Forward an external port on your router directly to your StartOS server's LAN IP on port 3333 and point miners at that.
- **simpleproxy on a second host**: Run `simpleproxy -L 3333 -R <startos-lan-ip>:3333` on any always-on LAN host and point miners at that host.
Once forwarding is in place, miners connect to `stratum+tcp://<forward-host>:3333` with the username set to **any label you like** (it becomes the worker name in the dashboard) and any password.
Once forwarding is in place, miners connect to `stratum+tcp://<forward-host>:3333` with the username set to **the Bitcoin address that should receive the block reward** (optionally followed by `.workername` for labelling in the dashboard). The password field is ignored.
## Troubleshooting