Network:¶

-o, --url=URL

URL of mining server

-a, --algo=ALGO

mining algorithm https://xmrig.com/docs/algorithms

--coin=COIN

specify coin instead of algorithm

-u, --user=USERNAME

username for mining server

-p, --pass=PASSWORD

password for mining server

-O, --userpass=U:P

username:password pair for mining server

-x, --proxy=HOST:PORT

connect through a SOCKS5 proxy

-k, --keepalive

send keepalived packet for prevent timeout (needs pool support)

--nicehash

enable nicehash.com support

--rig-id=ID

rig identifier for pool-side statistics (needs pool support)

--tls

enable SSL/TLS support (needs pool support)

--tls-fingerprint=HEX

pool TLS certificate fingerprint for strict certificate pinning

--dns-ipv6

prefer IPv6 records from DNS responses

--dns-ttl=N

N seconds (default: 30) TTL for internal DNS cache

--daemon

use daemon RPC instead of pool for solo mining

--daemon-zmq-port=N

daemon's zmq-pub port number (only use it if daemon has it enabled)

--daemon-poll-interval=N

daemon poll interval in milliseconds (default: 1000)

--daemon-job-timeout=N

daemon job timeout in milliseconds (default: 15000)

--self-select=URL

self-select block templates from URL

--submit-to-origin

also submit solution back to self-select URL

-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)

--user-agent

set custom user-agent string for pool

--donate-level=N

donate level, default 1%% (1 minute 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, proper CPU affinity required for some optimizations.

--cpu-affinity=N

set process affinity to CPU core(s), mask 0x3 for cores 0 and 1

-v, --av=N

algorithm variation, 0 auto select

--cpu-priority=N

set process priority (0 idle, 2 normal to 5 highest)

--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)

--cpu-no-yield

prefer maximum hashrate rather than system response/stability

--no-huge-pages

disable huge pages support

--hugepage-size=N

custom hugepage size in kB

--huge-pages-jit

enable huge pages support for RandomX JIT code

--asm=ASM

ASM optimizations, possible values: auto, none, intel, ryzen, bulldozer

--argon2-impl=IMPL

argon2 implementation: x86_64, SSE2, SSSE3, XOP, AVX2, AVX-512F

--randomx-init=N

threads count to initialize RandomX dataset

--randomx-no-numa

disable NUMA support for RandomX

--randomx-mode=MODE

RandomX mode: auto, fast, light

--randomx-1gb-pages

use 1GB hugepages for RandomX dataset (Linux only)

--randomx-wrmsr=N

write custom value(s) to MSR registers or disable MSR mod (-1)

--randomx-no-rdmsr

disable reverting initial MSR values on exit

--randomx-cache-qos

enable Cache QoS

OpenCL backend:¶

--opencl

enable OpenCL mining backend

--opencl-devices=N

comma separated list of OpenCL devices to use

--opencl-platform=N

OpenCL platform index or name

--opencl-loader=PATH

path to OpenCL-ICD-Loader (OpenCL.dll or libOpenCL.so)

--opencl-no-cache

disable OpenCL cache

--print-platforms

print available OpenCL platforms and exit

CUDA backend:¶

--cuda

enable CUDA mining backend

--cuda-loader=PATH

path to CUDA plugin (xmrig-cuda.dll or libxmrig-cuda.so)

--cuda-devices=N

comma separated list of CUDA devices to use

--cuda-bfactor-hint=N

bfactor hint for autoconfig (0-12)

--cuda-bsleep-hint=N

bsleep hint for autoconfig

--no-nvml

disable NVML (NVIDIA Management Library) support

API:¶

--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)

TLS:¶

--tls-gen=HOSTNAME

generate TLS certificate for specific hostname

--tls-cert=FILE

load TLS certificate chain from a file in the PEM format

--tls-cert-key=FILE

load TLS certificate private key from a file in the PEM format

--tls-dhparam=FILE

load DH parameters for DHE ciphers from a file in the PEM format

--tls-protocols=N

enable specified TLS protocols, example: "TLSv1 TLSv1.1 TLSv1.2 TLSv1.3"

--tls-ciphers=S

set list of available ciphers (TLSv1.2 and below)

--tls-ciphersuites=S

set list of available TLSv1.3 ciphersuites

Logging:¶

-S, --syslog

use system log for output messages

-l, --log-file=FILE

log all output to a file

--print-time=N

print hashrate report every N seconds

--health-print-time=N

print health report every N seconds

--no-color

disable colored output

--verbose

verbose output

Misc:¶

-c, --config=FILE

load a JSON-format configuration file

-B, --background

run the miner in the background

-V, --version

output version information and exit

-h, --help

display this help and exit

--dry-run

test configuration and exit

--export-topology

export hwloc topology to a XML file and exit

--pause-on-battery

pause mine on battery power

--pause-on-active=N

pause mine when the user is active (resume after N seconds of last activity)

--stress

run continuous stress test to check system stability

--bench=N

run benchmark, N can be between 1M and 10M

--submit

perform an online benchmark and submit result for sharing

--verify=ID

verify submitted benchmark by ID

--seed=SEED

custom RandomX seed for benchmark

--hash=HASH

compare benchmark result with specified hash

--no-dmi

disable DMI/SMBIOS reader

features: 64-bit AES

libuv/1.48.0 OpenSSL/3.3.2 hwloc/2.11.2