cbac54179a
# 2.2.0
* Integrated RandomxARQ algo (rx/arq)
* Dashboard:
* Flipped push/pull button on Dashboard
* Only update algo+pool when its not donating
* Fixed segfault when stopping xmrigCCServer
12 KiB
XMRigCC
⚠️ Monero will change PoW algorithm to RandomX on November 30. Make sure you upgrade to the latest Release before that
XMRig is a high performance RandomX, CryptoNight and Argon2 CPU miner, with official support for Windows.
💡 This is the CPU variant of XMRigCC, if you're looking for the AMD GPU (OpenCL) variant click here.
About XMRigCC
XMRigCC is a XMRig fork which adds remote control and monitoring functions to XMRigCC miners. It lets you control your miners via a Dashboard or the REST api. XMRigCC has a "Command and Control" (C&C) server part, a daemon to keep the XMRigCC miner alive and modifications to send the current status to the C&C Server. The modified version can handle commands like "update config", "start/stop mining" or "restart/shutdown/reboot" which can be send from the C&C-Server Dashboard. Assign config templates to multiple miners with a single click and let them switch configs without connecting to each of them. Watch your miners logs with the simple remote Log viewer and monitor you miners. When the hashrate drops or one of your miners went offline you can get a notification via PushOver or Telegram automatically so that you dont need to watch your miners all day.
Full Windows/Linux compatible, and you can mix Linux and Windows miner on one XMRigCCServer.
Additional features of XMRigCC (on top of XMRig)
Check the Coin Configuration guide
- Support of RandomxARQ variant (algo: "rx/arq")
- Support of UPX2 variant (algo: "cn-extremelite/upx2")
- Support of CN-Conceal variant (algo: "cn/conceal")
- Better performance for ARMv8 CPUs
- Full SSL/TLS support
- NUMA support
- Command and control server
- CC Dashboard with:
- statistics of all connected miners
- remote control miners (start/stop/restart/shutdown)
- remote configuration changes of miners
- simple config editor for miner / config templates
- monitoring / offline notification push notifications via Pushover and Telegram
- Daemon to restart the miner
XMRigCC Miner
XMRigCC Server
XMRigCC Dashboard
Table of contents
Download
- Binary releases: https://github.com/Bendr0id/xmrigCC/releases
- Git tree: https://github.com/Bendr0id/xmrigCC.git
- Clone with
git clone https://github.com/Bendr0id/xmrigCC.git🔨 [Build instructions](https://github.com/xmrig/xmrig/wiki/Build.
- Clone with
Usage
Basic example XMRigCCServer
xmrigServer --port=3344 --user=admin --pass=pass --access-token=SECRET_TOKEN_TO_ACCESS_CC_SERVER
Options XMRigCCServer
-b, --bind arg The CC Server bind ip (default: 0.0.0.0)
-p, --port N The CC Server port
-U, --user arg The CC Server admin user
-P, --pass arg The CC Server admin pass
-T, --token arg The CC Server access token for the CC Client
-t, --tls Enable SSL/TLS support
-K, --key-file FILE The private key file to use when TLS is ON
(default: server.key)
-C, --cert-file FILE The cert file to use when TLS is ON (default:
server.pem)
-B, --background Run the Server in the background
-S, --syslog Log to the syslog
--no-colors Disable colored output
--pushover-user-key arg The user key for pushover notifications
--pushover-api-token arg The api token/keytoken of the application for
pushover notification
--telegram-bot-token arg The bot token for telegram notifications
--telegram-chat-id arg The chat-id for telegram notifications
--push-miner-offline-info
Push notification for offline miners and
recovery (default: true)
--push-miner-zero-hash-info
Push notification when miner reports 0
hashrate and recovers (default: true)
--push-periodic-mining-status
Push every hour a status notification
(default: true)
--custom-dashboard FILE The custom dashboard to use (default:
index.html)
--client-config-folder FOLDER
The CC Server access token for the CC Client
--log-file FILE The log file to write
--client-log-lines-history N
Maximum lines of log history kept per miner
(default: 100)
-c, --config FILE The JSON-format configuration file to use
-h, --help Print this help
Basic example xmrigDaemon
xmrigDaemon -o pool.hashvault.pro:5555 -u YOUR_WALLET -p x -k --cc-url=IP_OF_CC_SERVER:PORT --cc-access-token=SECRET_TOKEN_TO_ACCESS_CC_SERVER --cc-worker-id=OPTIONAL_WORKER_NAME
Options xmrigDaemon
-a, --algo=ALGO specify the algorithm to use
cn/r, cn/2, cn/1, cn/0, cn/double, cn/half, cn/fast,
cn/rwz, cn/zls, cn/xao, cn/rto, cn/conceal,
cn-lite/1,
cn-heavy/xhv, cn-heavy/tube, cn-heavy/0,
cn-pico
cn-extremelite
argon2/chukwa, argon2/wrkz
rx/wow, rx/loki, rx/arq
--coin=COIN specify coin instead of algorithm
-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
--rig-id=ID rig identifier for pool-side statistics (needs pool support)
-t, --threads=N number of miner threads
-v, --av=N algorithm variation, 0 auto select
-k, --keepalive send keepalived packet for prevent timeout (needs pool support)
--nicehash enable nicehash.com support
--tls enable SSL/TLS support (needs pool support)
--tls-fingerprint=F pool TLS certificate fingerprint, if set enable strict certificate pinning
--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)
--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
--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
--asm=ASM ASM optimizations, possible values: auto, none, intel, ryzen, bulldozer.
--print-time=N print hashrate report every N seconds
--api-worker-id=ID custom worker-id for API
--api-id=ID custom instance ID for API
--http-enabled enable HTTP 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)
--randomx-init=N threads count to initialize RandomX dataset
--randomx-no-numa disable NUMA support for RandomX
--export-topology export hwloc topology to a XML file and exit
--cc-disabled disable CC Client feature
--cc-url=URL url of the CC Server
--cc-access-token=T access token for CC Server
--cc-worker-id=ID custom worker-id for CC Server
--cc-update-interval-s=N status update interval in seconds (default: 10 min: 1)
--cc-use-tls enable tls encryption for CC communication
--cc-use-remote-logging enable remote logging on CC Server
--cc-upload-config-on-start upload current miner config to CC Server on startup
--cc-reboot-cmd=CMD command/bat to execute to Reboot miner machine
--dry-run test configuration and exit
-h, --help display this help and exit
-V, --version output version information and exit
Common Issues
XMRigMiner
- XMRigMiner is just the worker, it is not designed to work standalone. Please start XMRigDaemon instead.
Windows only: DLL error on starting
- Make sure that you installed latest Visual C++ Redistributable for Visual Studio 2015. Can be downloaded here: microsoft.com
Linux only: Background mode
-
The
--backgroundoption will only work properly for the XMRigServer. But there is a simple workaround for the XMRigDaemon process. Just append an&to the command and it will run smoothly in the background../xmrigDaemon --config=my_config_cc.json &or you just usescreen
HUGE PAGES unavailable (Windows)
- Run XMRigDaemon as Administrator.
- On Windows it automatically enables SeLockMemoryPrivilege for current user, but reboot or sign out still required. Manual instruction.
HUGE PAGES unavailable (Linux)
-
Before starting XMRigDaemon set huge pages
sudo sysctl -w vm.nr_hugepages=128
Donations
- Default donation 5% (5 minutes in 100 minutes) can be reduced to 1% via command line option
--donate-level.
BenDroid (XMRigCC):
XMR: 4BEn3sSa2SsHBcwa9dNdKnGvvbyHPABr2JzoY7omn7DA2hPv84pVFvwDrcwMCWgz3dQVcrkw3gE9aTC9Mi5HxzkfF9ev1eH
AEON: Wmtm4S2cQ8uEBBAVjvbiaVAPv2d6gA1mAUmBmjna4VF7VixLxLRUYag5cvsym3WnuzdJ9zvhQ3Xwa8gWxPDPRfcQ3AUkYra3W
BTC: 3Gwq9tveCZtLAiXX7mxhjbrh38GPx1iXdB
xmrig:
XMR: 48edfHu7V9Z84YzzMa6fUueoELZ9ZRXq9VetWzYGzKt52XU5xvqgzYnDK9URnRoJMk1j8nLwEVsaSWJ4fhdUyZijBGUicoD
BTC: 1P7ujsXeX7GxQwHNnJsRMgAdNkFZmNVqJT