Go to file
XMRig 0b5587fd6a Add commands help. 2017-07-23 10:04:23 +03:00
cmake Fix linux build. 2017-06-14 16:11:01 +03:00
res Initial libuv support build. 2017-06-04 20:52:21 +03:00
src Add commands help. 2017-07-23 10:04:23 +03:00
test * Implement --max-cpu-usage. 2017-05-10 19:38:35 +03:00
.gitignore Initial libuv support build. 2017-06-04 20:52:21 +03:00
CHANGELOG.md Update CHANGELOG.md 2017-07-20 02:56:07 +03:00
CMakeLists.txt Added IConsoleListener 2017-07-23 09:36:30 +03:00
LICENSE Initial import. 2017-04-15 09:02:08 +03:00
README.md Update README.md 2017-07-12 14:02:07 +03:00

README.md

XMRig

XMRig is high performance Monero (XMR) CPU miner, with the official full Windows support. Originally based on cpuminer-multi with heavy optimizations/rewrites and removing a lot of legacy code, since version 1.0.0 complete rewritten from scratch on C++.

Table of contents

Features

  • High performance (290+ H/s on i7 6700).
  • Official Windows support.
  • Small Windows executable, only 535 KB without dependencies.
  • Support for backup (failover) mining server.
  • keepalived support.
  • Command line options compatible with cpuminer.
  • CryptoNight-Lite support for AEON.
  • Smart automatic CPU configuration.
  • Nicehash support
  • It's open source software.

Download

Usage

Basic example

xmrig.exe -o xmr-eu.dwarfpool.com:8005 -u YOUR_WALLET -p x -k

Failover

xmrig.exe -o pool.supportxmr.com:5555 -u YOUR_WALLET1 -k -o xmr-eu.dwarfpool.com:8005 -u YOUR_WALLET2 -p x -k

For failover you can add multiple pools, maximum count not limited.

Options

  -a, --algo=ALGO       cryptonight (default) or cryptonight-lite
  -o, --url=URL         URL of mining server
  -O, --userpass=U:P    username:password pair for mining server
  -u, --user=USERNAME   username for mining server
  -p, --pass=PASSWORD   password for mining server
  -t, --threads=N       number of miner threads
  -v, --av=N            algorithm variation, 0 auto select
  -k, --keepalive       send keepalived for prevent timeout (need pool support)
  -r, --retries=N       number of times to retry before switch to backup server (default: 5)
  -R, --retry-pause=N   time to pause between retries (default: 5)
      --cpu-affinity    set process affinity to cpu core(s), mask 0x3 for cores 0 and 1
      --no-color        disable colored output
      --donate-level=N  donate level, default 5% (5 minutes in 100 minutes)
  -B, --background      run the miner in the background
  -c, --config=FILE     load a JSON-format configuration file
      --max-cpu-usage=N maximum cpu usage for automatic threads mode (default 75)
      --safe            safe adjust threads and av settings for current cpu
      --nicehash        enable nicehash support
      --print-time=N    print hashrate report every N seconds
  -h, --help            display this help and exit
  -V, --version         output version information and exit

Algorithm variations

Since version 0.8.0.

  • --av=1 For CPUs with hardware AES.
  • --av=2 Lower power mode (double hash) of 1.
  • --av=3 Software AES implementation.
  • --av=4 Lower power mode (double hash) of 3.

Common Issues

HUGE PAGES unavailable

  • Run XMRig as Administrator.
  • Since version 0.8.0 XMRig automatically enable SeLockMemoryPrivilege for current user, but reboot or sign out still required. Manual instruction.

Other information

  • No HTTP support, only stratum protocol support.
  • No TLS support.
  • Default donation 5% (5 minutes in 100 minutes) can be reduced to 1% via command line option --donate-level.

CPU mining performance

  • i7-6700 - 290+ H/s (4 threads, cpu affinity 0xAA)
  • Dual E5620 - 377 H/s (12 threads, cpu affinity 0xEEEE)

Please note performance is highly dependent on system load. The numbers above are obtained on an idle system. Tasks heavily using a processor cache, such as video playback, can greatly degrade hashrate. Optimal number of threads depends on the size of the L3 cache of a processor, 1 thread requires 2 MB of cache.

Maximum performance checklist

  • Idle operating system.
  • Do not exceed optimal thread count.
  • Use modern CPUs with AES-NI instructuon set.
  • Try setup optimal cpu affinity.
  • Enable fast memory (Large/Huge pages).

Donations

  • XMR: 48edfHu7V9Z84YzzMa6fUueoELZ9ZRXq9VetWzYGzKt52XU5xvqgzYnDK9URnRoJMk1j8nLwEVsaSWJ4fhdUyZijBGUicoD
  • BTC: 1P7ujsXeX7GxQwHNnJsRMgAdNkFZmNVqJT

Contacts