Skip to content

RAWGamingNet/xmr-stak-docker

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

xmr-stak Universal Docker Miner

Docker Stars Docker Pulls Docker Build Status Docker Layers

xmr-stak docker image that can mine CPU, AMD, and NVIDIA at the same time. One mining container to rule them all!

Tags

  • latest: the latest stable version
  • develop: the latest testing version (may not be stable). A new version of xmr-stak will start here and typically migrate shortly to beta.
  • experimental: a completely untested version running an experimental build
  • beta: the next upcoming release version. A develop version will migrate here, and typically migrate shortly to latest.
  • VERSION: the tagged version of xmr-stak build

Usage

  • A simple one liner to get the container mining right away
docker run --runtime=nvidia --device=/dev/dri --device=/dev/kfd --group-add=video -it -d --name xmr-stak -p 8000:8000  -v xmr-stak-config:/config patsissons/xmr-stak:develop -o ca.minexmr.com:5555 -u 47NHecs6qjvDcbx3eW6cDGDwdm3gDqbHs7G8hzPYRxf3YRTcDJw8kXhDxfHinsjHUwVwdFusSn76UHkaz68KurUgHvFmPMH.github-xmr-stak -p x --currency monero --httpd 8000
  • A more comprehensive script to simplify the process of starting and uprading the miner. Running sudo ./start-xmr-stak.sh will pull down the latest version while still mining, then stop and upgrade the container to resume mining with minimal downtime. If you want to use this script with the latest develop builds, run sudo ./start-xmr-stak.sh develop instead. The script is ready to accept overrides for a few environment variables to simplify multi-host distribution.
Environment Variable Default Value Notes
ADDRESS N/A make sure to replace the default with your own address or you will be mining to my address
HOST hostname -s override this if you want a custom host name that is different from your actual host name
PORT 8000 if another container or process is already using port 8000 this can be adjusted
POOL_HOST N/A make sure to replace this with your own pool remote uri
POOL_USER $ADDRESS.$HOST-$TAG adjust this to your needs
POOL_PASS x adjust this to your needs
CURRENCY monero adjust this to your needs

Host requirements

Everything has been tested on Ubuntu 16 LTS (Xenial), but may also possibly work on Ubuntu 18 LTS (Bionic). For the most stable results, try and ensure your docker container environments match the host environment, especially for driver versions.

AMD Requirements

AMD requires only drivers installed on the host to interact with the hardware.

amdgpu-pro

You need to have installed the AMDGPU-Pro drivers (17.40-514569) on the host machine and then run the docker image with --device=/dev/dri --device=/dev/kfd --group-add=video.

Testing

  • check the status of the amdgpu-pro host driver installation.

/opt/amdgpu-pro/bin/clinfo

  • check the status of the docker integration

docker run -it --rm --device=/dev/dri --device=/dev/kfd --group-add=video --entrypoint=/bin/sh patsissons/xmr-stak -c /opt/amdgpu-pro/bin/clinfo

NVIDIA Requirements

NVIDIA requires both a docker runtime and cuda drivers installed on the host to interact with the hardware.

nvidia-docker

You need to have already installed nvidia-docker to enable passthru on the nvidia card(s). You will also need to have the cuda-drivers (10.1) installed. Run the docker container with --runtime=nvidia to enable the NVIDIA passthrough.

cuda-drivers

Installing cuda drivers on Ubuntu 16 LTS is the easiest way to get things going. You can install the drivers with apt-get install --no-install-recommends cuda-drivers. Make sure to reboot after installing new drivers.

Testing

  • check the status of the cuda-drivers host driver installation.

/usr/bin/nvidia-smi

  • check the status of the docker integration

docker run -it --rm --runtime=nvidia --entrypoint=/bin/sh patsissons/xmr-stak -c /usr/bin/nvidia-smi

Donations

If you find this docker image useful, donations for work on dockerizing mining app are appreciated at any of the following addresses:

  • BTC: 1LNY9wSPs913Y9jXMTrrVze1E41nhm6Qv7
  • LTC: LhnwdbrnQaQbjDkqxXFmxXGPcFhMBA9gFu
  • XMR: 47NHecs6qjvDcbx3eW6cDGDwdm3gDqbHs7G8hzPYRxf3YRTcDJw8kXhDxfHinsjHUwVwdFusSn76UHkaz68KurUgHvFmPMH

Acknowledgements

About

xmr-stak docker image that can mine CPU, AMD, and NVIDIA at the same time

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Dockerfile 78.9%
  • Shell 21.1%