magicdude4eva/cksolo repository overview

⁠CKPool Solo (cksolo)

This container runs CKPool Solo⁠ — a minimalistic, direct-to-node mining pool. It allows your ASIC miner (e.g. NerdQAxe) to submit work to your local bitcoind node without any third-party dependency.

⁠Features

• Lightweight C-based stratum server
• Solo mining compatible with Bitcoin Core
• Logs output to bind-mounted volume
• Supports runtime and configuration directory mounts
• Based on debian:bookworm-slim

⁠Usage (via Docker Compose)

Before starting, ensure:

• Bitcoin Core is fully synced
• A proper ckpool.conf exists in your mounted config path

Start cksolo with:

docker compose --profile bitcoin up -d ckpool

Monitor logs with:

tail -f ./cksolo/logs/ckpool.log

⁠⚠️ Do Not Start Before Sync

Ensure your Bitcoin node reports:

"initialblockdownload": false

Otherwise, shares will be rejected and energy wasted.

⁠Volumes

The container expects the following volumes:

• /cksolo/logs/ckpool.log — mining log (parsed by CKStats)
• /cksolo/config/ckpool.conf — stratum config with address, payout, and pool name

⁠Ports

• 3333 – Default stratum port

⁠Configuration

You must provide a valid ckpool.conf in the /ckpool-conf volume mount. The container will exit if the file is missing.

⁠Example config snippet

⁠"btcd": "/bitcoin/.bitcoin/bitcoin.conf", "rpcurl": "http://user:pass@bitcoind:8332⁠", "coin": "bitcoin", "logfile": "/logs/ckpool.log", "port": 3333

⁠Notes

• This image compiles ckpool-solo from source (solobtc branch)
• The stratum server writes all output to /logs/ckpool.log
• Does not include a web UI — pair with ckstats if desired

⁠📦 Image Details

• Based on upstream ckpool-solo branch
• Exposes:
  • Port 3333 for Stratum mining connections

More: Overview README⁠

⁠Donations are always welcome

🍻 Support my work
All my software is free and built in my personal time. If it helps you or your business, please consider a small donation via PayPal⁠ — it keeps the coffee ☕ and ideas flowing!

💸 Crypto Donations
You can also send crypto to one of the addresses below:

(BTC)   bc1qdgdkk7l98pje8ny9u4xavsvrea8dw6yu8jpnyf
(ETH)   0x5986f713A538D6bCaC0865564dCD45E2600A3469  
(POL)   0x5986f713A538D6bCaC0865564dCD45E2600A3469
(CRO)   0xb83c3Fe378F5224fAdD7a0f8a7dD33a6C96C422C (Cronos or Crypto.com Paystring magicdude$paystring.crypto.com)
(BNB)   0x5986f713A538D6bCaC0865564dCD45E2600A3469
(LTC)   ltc1qexst2exxksfyg7erfzlfrm23twkjgf7e5fn64t
(DOGE)  DMQsxc9XGF6526drBJDZeX7AjFDJsEz4mN
(SOL)   t4bYQCUuoCUrp7kJ4Mz314npcTuKoUSXj28UgdMrfTb

🧾 Recommended Platforms

• 👉 Curve.com⁠: Add your Crypto.com card to Apple Pay
• 🔐 Crypto.com⁠: Stake and get your free Crypto Visa card
• 📈 Binance⁠: Trade altcoins easily