So you’ve been doing a lot of research around the blockchain and the various cryptocurrencies. Don’t worry, I’ve been doing a lot of the same research. There is so much in the news and on social media around this subject, it would be a good idea to educate yourself.
When it comes to cryptocurrencies, there are a lot of people trying to mine it rather than buy it. Depending on the type of currency, it could be near impossible to mine or very easy. Take Bitcoin for example. Bitcoin is one of the most difficult coins to mine, while others such as DigiByte are much easier. That’s not to say the easier coins won’t become more difficult in the future.
So how do you get started with mining?
I use a Mac. If you’re a Mac owner and you try to find a mining tool online, you’re going to struggle because most are for Windows or Linux. We’re going to see how to leverage Docker to mine via a Linux container on any platform.
When it comes to mining, there is CPU mining and GPU mining. Most will tell you that GPU mining will yield better results, but at a higher cost. It will put more stress on your machine and your electrical bill. We’re going to focus on CPU mining.
The most popular CPU miner tool is called cpuminer and there are several variations of it. The maintained original version can use the scrypt and sha256 algorithms which is useful for Bitcoin, Litecoin, and any other coins that can be mined with those algorithms.
The GitHub repository for cpuminer has a Dockerfile file included for easily creating a Docker image:
FROM ubuntu:14.04 MAINTAINER Guillaume J. Charmes <firstname.lastname@example.org> RUN apt-get update -qq && \ apt-get install -qqy automake libcurl4-openssl-dev git make RUN git clone https://github.com/pooler/cpuminer RUN cd cpuminer && \ ./autogen.sh && \ ./configure CFLAGS="-O3" && \ make WORKDIR /cpuminer ENTRYPOINT ["./minerd"]
The configuration above was taken from the Dockerfile file. To build it into a useable image, execute the following with the Docker CLI:
docker build -t cpuminer ./path/to/Dockerfile
Like I had previously mentioned, the maintained original cpuminer only does two algorithms. This can limit your productivity if you’re trying to mine a specific coin. Instead, we may want to check out the cpuminer-multi project which supports a significant amount of algorithms.
The cpuminer-multi project has a Dockerfile file in the GitHub repository that looks like the following:
FROM ubuntu:14.04 MAINTAINER Tanguy Pruvot <email@example.com> RUN apt-get update -qq RUN apt-get install -qy automake autoconf pkg-config libcurl4-openssl-dev libssl-dev libjansson-dev libgmp-dev make g++ git RUN git clone https://github.com/tpruvot/cpuminer-multi -b linux RUN cd cpuminer-multi && ./build.sh WORKDIR /cpuminer-multi ENTRYPOINT ["./cpuminer"]
The above configuration is very similar to that of the original project. To build it, execute the following from the Docker CLI:
docker build -t cpuminer-multi ./path/to/Dockerfile
Regardless of the cpuminer variation that you plan on using, the build time may take a few minutes. The build process is downloading a fair amount of dependencies and building the project from source.
Now that we have a CPU mining tool ready to go via Docker and containerization, we have to choose a pool to join and the type of coin that we wish to mine.
We’re going to use the qubit algorithm, for this reason we’ll need to use the cpuminer-multi image that we had created. From the CLI, execute the following:
docker run -d cpuminer-multi --algo qubit --url stratum+tcp://digihash.co:3012 --user D9Ms9hnm32q9nceN2b9jNshuZhWcobrmQm --pass anything --threads 3
Just so we’re on the same page, the D9Ms9hnm32q9nceN2b9jNshuZhWcobrmQm username in the above command is my public DGB address where mined coins will be sent. You’ll want to replace it with your own address. I have a quad-core CPU, so by choosing to use three threads, I’m using three of my four cores.
To see the progress of your mining, execute the following to obtain your container id:
You should see results that look like the following:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 6dd40d6130fe cpuminer-multi "./cpuminer --algo..." 4 seconds ago Up 2 seconds gallant_gates
With the container id, execute the following to see a live stream of your logs:
docker logs -f 6dd40d6130fe
Remember we’re running our container in detached mode, meaning it will be running as a container in the background. You don’t always need to be tracking the logs.
Most of the logs will spit out information that looks like the following:
[2017-12-20 18:12:25] Starting Stratum on stratum+tcp://digihash.co:3012 [2017-12-20 18:12:25] 3 miner threads started, using 'qubit' algorithm. [2017-12-20 18:12:29] Stratum difficulty set to 0.01 [2017-12-20 18:12:29] qubit block 5761269, diff 190162.631 [2017-12-20 18:12:31] qubit block 5761270, diff 182120.209 [2017-12-20 18:12:31] CPU #2: 76.54 kH/s [2017-12-20 18:12:31] CPU #1: 76.44 kH/s [2017-12-20 18:12:31] CPU #0: 76.50 kH/s [2017-12-20 18:12:36] qubit block 5761271, diff 172820.491 [2017-12-20 18:12:42] qubit block 5761272, diff 169053.910
This information lets us know that we’re successfully mining, but it doesn’t mean that we’ve found any coins. Occasionally, you’ll see something that looks like the following:
[2017-12-20 18:15:26] accepted: 1/1 (diff 0.116), 207.60 kH/s yes!
This does not mean that you’ve found a coin. It means that you’ve found a share in the pool. You’ll need to find quite a bit of these shares before you end up with a payout.
You just saw how to use Docker to mine for cryptocurrency on your computer. By using Docker, we don’t have to install a miner directly on our host and we don’t have to burden ourselves with trying to find or build for a specific platform. Within our Docker image, we have a Linux build that is ready to be deployed and used as a container at any given time.
Keep in mind that mining any kind of cryptocurrency coin on your computer is difficult, expensive, and probably taxing on your machine. People spend a lot of money on specialized mining hardware. However, play around with the concept, and you never know, you might get lucky.
If you end up striking gold in the form of cryptocurrency, consider donating some to me:
If you know of a better method to mine using Docker than what I’ve discussed above, share your thoughts in the comments. Many subscribers would benefit from the education on the subject.