This repository contains Docker images and Dockerfiles that let you get from zero to mining in around 5 minutes on any Linux host anywhere.
CPU mining can be profitable using algorithmns like: Cryptonight, Hodl or Equihash. Find out more about profitability here.
Disclaimer: this software is provided with no warranty. Use at your own risk. If you plan to mine on a cloud check the terms and conditions before you start. The same applies if you are using private equipment or an on-site datacenter for mining.
Tip: Mining will use all the CPU resources available on the machine so do not run it where you have critical applications.
How does it work?
Instead of mining BitCoin or other currencies on your own this software works by connecting your CPU / GPU to a mining pool. You get paid for the shares your computer makes towards solving a block. The NiceHash mining pool used in this example lets you mine using two dozen different algorithms and can tell you what is most profitable for your hardware.
- What should I mine?
At time of writing a quad-core Intel CPU would be best mining Cryptonight, Hodl or Equihash.
- How do I get a wallet?
- What is the barrier to entry?
There barrier to entry is super low - you just have to have a Linux system connected to the Internet where you can install Docker. That's it. You then run the image I've already built and start accruing Bitcoins.
- Can I use my Raspberry Pi cluster?
Absolutely not.. there is no point even going there and believe me I've tried. You may find an obscure "alt coin" that can be mined with a Raspberry Pi but getting the money out of an obscure mining pool or exchange is more trouble than it's worth.
- Is it profitable?
It can be profitable depending on your hardware and electricity costs. If you have a single node and can get paid 2-5USD / day for instance then that's going to equate to 60-150 USD / month. Now if you actually have 20 or 50 nodes you can apply a multiplier.
- Where have you tested this?
Tested on cloud, but as I mentioned - check T&Cs before starting. You take full responsibility for any breach of T&Cs.
- MacBook Pro 13" touchbar i5
- Intel Nuc i5 Gen 5
- Dell Optiplex Intel i7
- What is Docker?
Docker uses containers and immutable images to build and package software and all its dependencies. Read more here
Try my Hands-On Labs for Docker if you want to learn more.
Tip: If you have credits with a cloud provider or are using the Spot Instance market then this could be a way for you to generate some coin at a low cost.
We need to install Docker CE so that we can run a container. The container holds all the mining code and dependencies as a single immutable image. You can install with a single line using a utility script - I generally use this with Ubuntu, but other distributions are supported too.
- Install Docker CE:
curl -sL https://get.docker.com | sh
If not running as a root user then you should look at the final message about using
usermodto grant access to Docker to your user account. This may be something like
usermod alexellis -aG docker
- Setup Docker Swarm
We will be using Docker Swarm to control the container we're using for mining.
Type in the following:
docker swarm init
If this command complains about
--advertise-addr- then pass
Create a service and enter your bitcoin wallet ID:
- Mine Hodl
docker service create --mode=global \ --name miner alexellis2/cpu-opt:2018-1-2 ./cpuminer \ -a hodl \ -o stratum+tcp://hodl.usa.nicehash.com:3352 \ -u 1M2KME8VBx24RsU3Ed2dEkF9EFghn3jR2o.cloud1
- Mine Cryptonight
docker service create --mode=global \ --name miner alexellis2/cpu-opt:2018-1-2 ./cpuminer \ -a cryptonight \ -o stratum+tcp://cryptonight.usa.nicehash.com:3355 \ -u 1M2KME8VBx24RsU3Ed2dEkF9EFghn3jR2o.cloud1
You must replace "usa" with your location such as "hk" or "eu", read on.
Tip : If you are planning on using an Atom processor you will need to rebuild the image using the instructions below. Atom CPUs are not advised for mining.
Replace "1M2KME8VBx24RsU3Ed2dEkF9EFghn3jR2o" with your wallet ID and "cloud1" with the name of the host you're mining on if you want to track it.
If you live outside the EU then find your nearest Stratum proxy server from Nicehash and replace the
euURL with your nearest location.
If you're running the command for the second time then remove the service with:
docker service rm miner
Limiting CPU usage
This is a community suggestion from @linuxjuggler.
If you want you can limit the CPU usage using the
--limit-cpu option in the
docker service create command.
Also its worth mentionining that you can limit the CPU core usage by selecting which cores to target via
docker run alexellis2/cpu-opt:2018-1-2 ./cpuminer --help: --cpu-affinity set process affinity to cpu core(s), mask 0x3 for cores 0 and 1 --cpu-priority set process priority (default: 0 idle, 2 normal to 5 highest)
Limiting the amount of CPU or number of cores being used may mean you can continue to use the system for other purposes. It is also less likely to trigger a high CPU alert if you are running monitoring software.
To pause mining type in
docker service scale miner=0. To resume set the replicas to
To completely stop mining use
docker service rm miner
Rebuild the image
This is optional and not recommended for beginners.
If you need to rebuild the Docker image for updates or for a different CPU architecture/variation such as an Atom CPU:
git clone https://github.com/alexellis/mine-with-docker cd mine-with-docker/cpu-opt docker build -t cpu-opt:latest .
After rebuilding the image swap out
cpu-opt:latest or whatever you chose to call it in the
docker build command.
Monitor your balance / workers
You can use the nicehash UI to monitor your balance and predicted payout. Mining pools generally wait until you reach a certain (low) balance before sending an automatic transfer to your wallet.
Here's an example with my donation address:
Nicehash and many other mining pools have their own HTTP APIs where you can programatically query your hashing rate, balance and list of connected workers.
Tip: You can use different mining pools simply by adjusting the stratum URL passed in via the
-oflag to the container.
You can follow me on Twitter @alexellisuk or make a donation with Bitcoin or Ethereum below:
- BTC: 1M2KME8VBx24RsU3Ed2dEkF9EFghn3jR2o
- Bitcoin Cash: 1M2KME8VBx24RsU3Ed2dEkF9EFghn3jR2o
- ETH: 0x0D0c7108AD4180486E03B4Fc44AD794a209eCb37
- LTC: LTt4VGXJMXALgzyjw6zACRxigNADaDYNH9
Copyright Alex Ellis 2017-2018