2017-04-15 06:02:08 +00:00
# XMRig
2018-03-14 18:32:09 +00:00
2019-09-28 21:10:38 +00:00
**:warning: [Monero will change PoW algorithm to RandomX on November 30. ](https://github.com/xmrig/xmrig/issues/1204 )**
2018-02-01 22:14:39 +00:00
[![Github All Releases ](https://img.shields.io/github/downloads/xmrig/xmrig/total.svg )](https://github.com/xmrig/xmrig/releases)
2018-02-01 22:58:11 +00:00
[![GitHub release ](https://img.shields.io/github/release/xmrig/xmrig/all.svg )](https://github.com/xmrig/xmrig/releases)
[![GitHub Release Date ](https://img.shields.io/github/release-date-pre/xmrig/xmrig.svg )](https://github.com/xmrig/xmrig/releases)
2018-02-01 22:14:39 +00:00
[![GitHub license ](https://img.shields.io/github/license/xmrig/xmrig.svg )](https://github.com/xmrig/xmrig/blob/master/LICENSE)
[![GitHub stars ](https://img.shields.io/github/stars/xmrig/xmrig.svg )](https://github.com/xmrig/xmrig/stargazers)
[![GitHub forks ](https://img.shields.io/github/forks/xmrig/xmrig.svg )](https://github.com/xmrig/xmrig/network)
2019-11-01 21:03:03 +00:00
XMRig High performance, open source, cross platform RandomX, CryptoNight and Argon2 CPU/GPU miner, with official support for Windows.
## Mining backends
- **CPU** (x64/x86/ARM)
- **OpenCL** for AMD GPUs.
- **CUDA** for NVIDIA GPUs via external [CUDA plugin ](https://github.com/xmrig/xmrig-cuda ).
2017-08-20 06:48:31 +00:00
2019-08-09 12:44:33 +00:00
< img src = "doc/screenshot.png" width = "808" >
2017-04-15 06:56:09 +00:00
2017-04-15 06:02:08 +00:00
## Download
* Binary releases: https://github.com/xmrig/xmrig/releases
* Git tree: https://github.com/xmrig/xmrig.git
2017-08-18 03:47:51 +00:00
* Clone with `git clone https://github.com/xmrig/xmrig.git` :hammer: [Build instructions ](https://github.com/xmrig/xmrig/wiki/Build ).
2017-04-15 06:02:08 +00:00
## Usage
2019-09-20 20:06:38 +00:00
The preferred way to configure the miner is the [JSON config file ](src/config.json ) as it is more flexible and human friendly. The command line interface does not cover all features, such as mining profiles for different algorithms. Important options can be changed during runtime without miner restart by editing the config file or executing API calls.
2017-07-02 19:21:29 +00:00
2019-10-20 04:48:23 +00:00
* **[xmrig.com/wizard](https://xmrig.com/wizard)** helps you create initial configuration for the miner.
2019-11-01 21:03:03 +00:00
* **[workers.xmrig.info](http://workers.xmrig.info)** helps manage your miners via HTTP API.
2019-10-20 04:48:23 +00:00
2019-10-09 01:45:06 +00:00
### Command line options
2017-04-15 06:02:08 +00:00
```
2019-10-09 01:45:06 +00:00
Network:
2019-08-10 07:57:02 +00:00
-o, --url=URL URL of mining server
2019-10-09 01:45:06 +00:00
-a, --algo=ALGO mining algorithm https://xmrig.com/docs/algorithms
--coin=COIN specify coin instead of algorithm
2019-08-10 07:57:02 +00:00
-u, --user=USERNAME username for mining server
-p, --pass=PASSWORD password for mining server
2019-10-09 01:45:06 +00:00
-O, --userpass=U:P username:password pair for mining server
2019-08-10 07:57:02 +00:00
-k, --keepalive send keepalived packet for prevent timeout (needs pool support)
--nicehash enable nicehash.com support
2019-10-09 01:45:06 +00:00
--rig-id=ID rig identifier for pool-side statistics (needs pool support)
2019-08-10 07:57:02 +00:00
--tls enable SSL/TLS support (needs pool support)
2019-10-09 01:45:06 +00:00
--tls-fingerprint=HEX pool TLS certificate fingerprint for strict certificate pinning
2019-08-10 07:57:02 +00:00
--daemon use daemon RPC instead of pool for solo mining
--daemon-poll-interval=N daemon poll interval in milliseconds (default: 1000)
-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)
2019-10-09 01:45:06 +00:00
--user-agent set custom user-agent string for pool
--donate-level=N donate level, default 5%% (5 minutes in 100 minutes)
--donate-over-proxy=N control donate over xmrig-proxy feature
CPU backend:
--no-cpu disable CPU mining backend
-t, --threads=N number of CPU threads
-v, --av=N algorithm variation, 0 auto select
2019-08-10 07:57:02 +00:00
--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)
2019-10-09 01:45:06 +00:00
--cpu-max-threads-hint=N maximum CPU threads count (in percentage) hint for autoconfig
--cpu-memory-pool=N number of 2 MB pages for persistent memory pool, -1 (auto), 0 (disable)
2019-08-10 07:57:02 +00:00
--no-huge-pages disable huge pages support
2019-10-09 01:45:06 +00:00
--asm=ASM ASM optimizations, possible values: auto, none, intel, ryzen, bulldozer
--randomx-init=N threads count to initialize RandomX dataset
--randomx-no-numa disable NUMA support for RandomX
API:
2019-08-10 07:57:02 +00:00
--api-worker-id=ID custom worker-id for API
--api-id=ID custom instance ID for API
--http-host=HOST bind host for HTTP API (default: 127.0.0.1)
--http-port=N bind port for HTTP API
--http-access-token=T access token for HTTP API
--http-no-restricted enable full remote access to HTTP API (only if access token set)
2019-10-09 01:45:06 +00:00
OpenCL backend:
--opencl enable OpenCL mining backend
2019-11-12 17:40:22 +00:00
--opencl-devices=N comma separated list of OpenCL devices to use
2019-10-09 01:45:06 +00:00
--opencl-platform=N OpenCL platform index or name
2019-10-28 17:42:49 +00:00
--opencl-loader=PATH path to OpenCL-ICD-Loader (OpenCL.dll or libOpenCL.so)
2019-10-09 01:45:06 +00:00
--opencl-no-cache disable OpenCL cache
--print-platforms print available OpenCL platforms and exit
2019-10-28 17:42:49 +00:00
CUDA backend:
--cuda enable CUDA mining backend
--cuda-loader=PATH path to CUDA plugin (xmrig-cuda.dll or libxmrig-cuda.so)
2019-11-12 17:40:22 +00:00
--cuda-devices=N comma separated list of CUDA devices to use
2019-10-31 21:08:52 +00:00
--no-nvml disable NVML (NVIDIA Management Library) support
2019-10-28 17:42:49 +00:00
2019-10-09 01:45:06 +00:00
Logging:
2019-10-28 17:42:49 +00:00
-S, --syslog use system log for output messages
2019-10-09 01:45:06 +00:00
-l, --log-file=FILE log all output to a file
--print-time=N print hashrate report every N seconds
2019-10-31 21:08:52 +00:00
--health-print-time=N print health report every N seconds
2019-10-09 01:45:06 +00:00
--no-color disable colored output
Misc:
-c, --config=FILE load a JSON-format configuration file
-B, --background run the miner in the background
2019-08-10 07:57:02 +00:00
-V, --version output version information and exit
2019-10-09 01:45:06 +00:00
-h, --help display this help and exit
--dry-run test configuration and exit
--export-topology export hwloc topology to a XML file and exit
2017-04-15 06:02:08 +00:00
```
2017-04-15 06:46:16 +00:00
## Donations
2019-08-09 13:09:00 +00:00
* Default donation 5% (5 minutes in 100 minutes) can be reduced to 1% via option `donate-level` or disabled in source code.
2017-04-15 06:46:16 +00:00
* XMR: `48edfHu7V9Z84YzzMa6fUueoELZ9ZRXq9VetWzYGzKt52XU5xvqgzYnDK9URnRoJMk1j8nLwEVsaSWJ4fhdUyZijBGUicoD`
2017-04-15 06:56:09 +00:00
* BTC: `1P7ujsXeX7GxQwHNnJsRMgAdNkFZmNVqJT`
2017-04-21 09:34:59 +00:00
## Contacts
* support@xmrig.com
* [reddit ](https://www.reddit.com/user/XMRig/ )
2018-10-01 10:36:03 +00:00
* [twitter ](https://twitter.com/xmrig_dev )