Mining software...
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

2.9 KiB

HowTo Use xmr-stak

Content Overview


Before you started the miner the first time there are no config files available. Config files will be created at the first start. The number of files depends on the available backends. config.txt contains the common miner settings. pools.txt contains the selected mining pools and currency to mine. amd.txt, cpu.txt and nvidia.txt contains miner backend specific settings and can be used for further tuning (Tuning Guide).

Note: If the pool is ignoring the option rig_id in pools.txt to name your worker please check the pool documentation how a worker name can be set.

Usage on Windows

  1. Double click the xmr-stak.exe file
  2. Fill in the pool url settings, currency, username and password

set XMRSTAK_NOWAIT=1 disable the dialog Press any key to exit. for non UAC execution.

Usage on Linux & macOS

  1. Open a terminal within the folder with the binary
  2. Start the miner with ./xmr-stak

Command Line Options

The miner allow to overwrite some of the settings via command line options. Run xmr-stak --help to show all available command line options.

Use Different Backends

On linux and OSX please add ./ before the binary name xmr-stak.

CPU Only:

xmr-stak --noAMD --noNVIDIA


The miner will automatically detect if CUDA (for NVIDIA GPUs) or OpenCL (for AMD GPUs) is available.

xmr-stak --noCPU

CUDA is currently not supported. I am currently try to get some performance out it.


It is possible to use the OpenCl backend which is originally created for AMD GPUs with NVIDIA GPus. Some NVIDIA GPUs can reach better performance with this backend.

xmr-stak --openCLVendor NVIDIA --noNVIDIA

Docker image usage

You can run the Docker image the following way:

docker run --rm -it -u $(id -u):$(id -g) --name fireice-uk/xmr-stak -v "$PWD":/mnt xmr-stak
docker stop xmr-stak
docker run --rm -it -u $(id -u):$(id -g) --name fireice-uk/xmr-stak -v "$PWD":/mnt xmr-stak --config config.txt

Debug the docker image by getting inside:

docker run --entrypoint=/bin/bash --rm -it -u $(id -u):$(id -g) --name fireice-uk/xmr-stak -v "$PWD":/mnt xmr-stak

HTML and JSON API report configuraton

To configure the reports shown on the README side you need to edit the httpd_port variable. Then enable wifi on your phone and navigate to [miner ip address]:[httpd_port] in your phone browser. If you want to use the data in scripts, you can get the JSON version of the data at url [miner ip address]:[httpd_port]/api.json