Public Repository

Last pushed: 4 months ago
Short Description
Full Description

What is XMR-Stak-CPU?

XMR-Stak-CPU is a universal Stratum pool miner. This is the CPU-mining version.

This docker image autoconfigures threads as suggested by xmr-stak-cpu. All xmr-stak-cpu's config.txt variables can be configured with docker run environment variables.


How to use this image

docker run -itd --restart unless-stopped -e WALLET_ADDRESS='' -e POOL_PASSWORD='' -e POOL_ADDRESS='' -e AUTO_THREAD_CONFIG=true --name xmr-stak-cpu timonmat/xmr-stak-cpu

or with 4 manually configured threads and stats on http port 80.

docker run -itd --restart unless-stopped \
-e WALLET_ADDRESS='<your-monero-wallet>' \
-e THREAD_CONFIG='{"low_power_mode" : false, "no_prefetch" : true, "affine_to_cpu" : 0 },{"low_power_mode" : false, "no_prefetch" : true, "affine_to_cpu" : 1 },{"low_power_mode" : false, "no_prefetch" : true, "affine_to_cpu" : 2 },{"low_power_mode" : false, "no_prefetch" : true, "affine_to_cpu" : 3 },' \
-e HTTPD_PORT=80 \
-p 80:80 \
--name xmr-stak-cpu timonmat/xmr-stak-cpu

'AUTO_THREAD_CONFIG=true' uses the xmr-stak-cpu recommended thread settings.

Without the AUTO_THREAD_CONFIG=true, or THREAD_CONFIG="" env variables the image starts up a number of threads equivalent to core count, which works best when you have for example 2 physical processors, and the (L3 cache/2) is higher than core count on one processor.

You can set all config.txt GitHub variables as docker run environment variables. Just use all caps in env var names.

Large pages need a properly set up OS. Run this on host side.

sudo sysctl -w vm.nr_hugepages=128 && ulimit -l 262144

Fetch logs of a container:


Donations for work on dockerizing are accepted at:

  • XMR: 4446nVBcqNvbAxRU3XBLiSVq1DuSohG8q6n9n7rhAMBiW88LeoMmHPnbcYxDgdSfCCgG3xW9zfhCQDnQRFNjwt1X3AyifpJ


This is a fork from Minecoins/docker-xmr-stak-cpu docker image, but with added env variable support, so thanks Minecoins!

Docker Pull Command