A Monero CPU miner that updates itself on every (re-)start.
The Dockerfile actually only specifies a very minimal base system. The real work is done by the provided Shell scripts.
init.shis a wrapper that calls the other scripts.deploy_monero.shfetches the current Monero binaries directly from getmonero.org and deploys them inside the container.start_mining.shstarts the Monero daemon monerod with the appropriate options for mining.
As init.sh is defined as the entrypoint for Docker, the deploy and start scripts will be executed on every (re-)start of the container. Thus, the image is automatically updated with the most current, stable Monero application.
Directory-wise everything is kept within /monero inside the container. It is highly recommended to map the directory /monero/data from the container to a persistent storage, as the blockchain will be stored inside this directory. If not kept persistent, the full blockchain must be synchronized every time the container is started.
When creating or running the container, please provide the XMR address that shall be mined for via XMRADDRESS and the number of threads used for mining via XMRTHREADS.
Please map the following directories to a persistent storage using Dockers -v parameter.
/monero/data: This should be mapped to a local directory as it contains the blockchain.
Please provide the following variables using Dockers -e parameter.
XMRADDRESS: The XMR wallet that mining should be done for. Defaults to the authors wallet.XMRTHREADS: The number of threads that shall be used for mining. Defaults to 1.
Monero requires port 18080 to be reachable from the Internet for RPC communication. Forward it using Dockers -p parameter.
Use docker build -t monero-cpu-miner:latest . to build the Docker image locally. A precompiled image can be fetched from Docker Hub by executing docker pull rbrtweiler/monero-cpu-miner:latest.
Assuming you want to mine for the wallet 431234...7890 using 3 threads and your persistent storage is setup in /var/docker/monero-cpu-miner. Replace the values in the example below with what you want to use.
Use docker create -it --name monero-cpu-miner --restart unless-stopped -e XMRADDRESS="431234...7890" -e XMRTHREADS=3 -v /var/docker/monero-cpu-miner:/monero/data -p 18080:18080 monero-cpu-miner:latest to create a persistent container. Afterwards, execute docker start monero-cpu-miner to start the container.
A one-time view of the current status can be obtained by executing docker logs monero-cpu-miner. In addition, it is possible to attach to the container using docker attach monero-cpu-miner. This will show the current status and enable you to interact with the monerod shell. Exit with Ctrl+p Ctrl+q.
The usual docker stop monero-cpu-miner can be used to stop the running container. To remove it completely, run docker rm monero-cpu-miner after stopping the container.
The original project is hosted at GitLab, with a copy over at GitHub for the folks over there.