146 lines
7.1 KiB
Markdown
146 lines
7.1 KiB
Markdown
# XMRig
|
|
|
|
:warning: **If you mine Monero, Aeon, Sumokoin, Turtlecoin, Stellite, GRAFT, Haven Protocol, IPBC, [PLEASE READ](https://github.com/xmrig/xmrig/issues/482)!** :warning:
|
|
|
|
[](https://github.com/xmrig/xmrig/releases)
|
|
[](https://github.com/xmrig/xmrig/releases)
|
|
[](https://github.com/xmrig/xmrig/releases)
|
|
[](https://github.com/xmrig/xmrig/blob/master/LICENSE)
|
|
[](https://github.com/xmrig/xmrig/stargazers)
|
|
[](https://github.com/xmrig/xmrig/network)
|
|
|
|
XMRig is a high performance Monero (XMR) CPU miner, with official support for Windows.
|
|
Originally based on cpuminer-multi with heavy optimizations/rewrites and removing a lot of legacy code, since version 1.0.0 completely rewritten from scratch on C++.
|
|
|
|
* This is the **CPU-mining** version, there is also a [NVIDIA GPU version](https://github.com/xmrig/xmrig-nvidia) and [AMD GPU version]( https://github.com/xmrig/xmrig-amd).
|
|
* [Roadmap](https://github.com/xmrig/xmrig/issues/106) for next releases.
|
|
|
|
<img src="http://i.imgur.com/OKZRVDh.png" width="619" >
|
|
|
|
#### Table of contents
|
|
* [Features](#features)
|
|
* [Download](#download)
|
|
* [Usage](#usage)
|
|
* [Algorithm variations](#algorithm-variations)
|
|
* [Build](https://github.com/xmrig/xmrig/wiki/Build)
|
|
* [Common Issues](#common-issues)
|
|
* [Other information](#other-information)
|
|
* [Donations](#donations)
|
|
* [Release checksums](#release-checksums)
|
|
* [Contacts](#contacts)
|
|
|
|
## Features
|
|
* High performance.
|
|
* Official Windows support.
|
|
* Small Windows executable, without dependencies.
|
|
* x86/x64 support.
|
|
* Support for backup (failover) mining server.
|
|
* keepalived support.
|
|
* Command line options compatible with cpuminer.
|
|
* CryptoNight-Lite support for AEON.
|
|
* Smart automatic [CPU configuration](https://github.com/xmrig/xmrig/wiki/Threads).
|
|
* Nicehash support
|
|
* It's open source software.
|
|
|
|
## Download
|
|
* Binary releases: https://github.com/xmrig/xmrig/releases
|
|
* Git tree: https://github.com/xmrig/xmrig.git
|
|
* Clone with `git clone https://github.com/xmrig/xmrig.git` :hammer: [Build instructions](https://github.com/xmrig/xmrig/wiki/Build).
|
|
|
|
## Usage
|
|
Use [config.xmrig.com](https://config.xmrig.com/xmrig) to generate, edit or share configurations.
|
|
|
|
### 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
|
|
--cpu-priority set process priority (0 idle, 2 normal to 5 highest)
|
|
--no-huge-pages disable huge pages support
|
|
--no-color disable colored output
|
|
--variant algorithm PoW variant
|
|
--donate-level=N donate level, default 5% (5 minutes in 100 minutes)
|
|
--user-agent set custom user-agent string for pool
|
|
-B, --background run the miner in the background
|
|
-c, --config=FILE load a JSON-format configuration file
|
|
-l, --log-file=FILE log all output to a file
|
|
-S, --syslog use system log for output messages
|
|
--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/xmrig-proxy support
|
|
--print-time=N print hashrate report every N seconds
|
|
--api-port=N port for the miner API
|
|
--api-access-token=T access token for API
|
|
--api-worker-id=ID custom worker-id for API
|
|
-h, --help display this help and exit
|
|
-V, --version output version information and exit
|
|
```
|
|
|
|
Also you can use configuration via config file, default **config.json**. You can load multiple config files and combine it with command line options.
|
|
|
|
## Algorithm variations
|
|
|
|
- `av` option used for automatic and simple threads mode (when you specify only threads count).
|
|
- For [advanced threads mode](https://github.com/xmrig/xmrig/issues/563) each thread configured individually and `av` option not used.
|
|
|
|
| av | Hashes per round | Hardware AES |
|
|
|----|------------------|--------------|
|
|
| 1 | 1 (Single) | yes |
|
|
| 2 | 2 (Double) | yes |
|
|
| 3 | 1 (Single) | no |
|
|
| 4 | 2 (Double) | no |
|
|
| 5 | 3 (Triple) | yes |
|
|
| 6 | 4 (Quard) | yes |
|
|
| 7 | 5 (Penta) | yes |
|
|
| 8 | 3 (Triple) | no |
|
|
| 9 | 4 (Quard) | no |
|
|
| 10 | 5 (Penta) | no |
|
|
|
|
## Common Issues
|
|
### HUGE PAGES unavailable
|
|
* Run XMRig as Administrator.
|
|
* Since version 0.8.0 XMRig automatically enables SeLockMemoryPrivilege for current user, but reboot or sign out still required. [Manual instruction](https://msdn.microsoft.com/en-gb/library/ms190730.aspx).
|
|
|
|
## Other information
|
|
* No HTTP support, only stratum protocol support.
|
|
* Default donation 5% (5 minutes in 100 minutes) can be reduced to 1% via option `donate-level`.
|
|
|
|
|
|
### CPU mining performance
|
|
* **Intel i7-7700** - 307 H/s (4 threads)
|
|
* **AMD Ryzen 7 1700X** - 560 H/s (8 threads)
|
|
|
|
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 instruction set.
|
|
* Try setup optimal cpu affinity.
|
|
* Enable fast memory (Large/Huge pages).
|
|
|
|
## Donations
|
|
* XMR: `48edfHu7V9Z84YzzMa6fUueoELZ9ZRXq9VetWzYGzKt52XU5xvqgzYnDK9URnRoJMk1j8nLwEVsaSWJ4fhdUyZijBGUicoD`
|
|
* BTC: `1P7ujsXeX7GxQwHNnJsRMgAdNkFZmNVqJT`
|
|
|
|
## Release checksums
|
|
### SHA-256
|
|
```
|
|
34d390a499d2098bce92e6b85b4858ee6255a7e2d4e03197ba4f6a759efe349c xmrig-2.6.4-xenial-amd64.tar.gz/xmrig-2.6.4/xmrig
|
|
cb6792c092c14f0f25d5774049a0adec403877a4564956220dcd9ba0fc488c82 xmrig-2.6.4-gcc-win32.zip/xmrig.exe
|
|
cb3c5619a8391f989c6a69135d890c3126eda9841b9dc591d44f02078a6fd49b xmrig-2.6.4-gcc-win64.zip/xmrig.exe
|
|
ea2e92bb10d0482880f8d389b7915948e11f672ca8559b0901d8a8fa8e9d733e xmrig-2.6.4-msvc-win64.zip/xmrig.exe
|
|
```
|
|
|
|
## Contacts
|
|
* support@xmrig.com
|
|
* [reddit](https://www.reddit.com/user/XMRig/)
|