This README's main purpose is to instruct on how to use and run the miner; for more information relating to the miner - supported platforms, supported coins, developer shares for the various configuration, performance for various hardware platforms, plans for the future, temperature on the back side of the moon, or anything else, please refer to either one of the three links below:
Basic Usage is
./<binaryName> <args> , with binary name and arguments as follows:
Depending on your architecture, pick:
luk-phi : for mining on 'bootable' x200 Xeon Phi nodes
luk-mpss-knl : For MPSS offload to x200 Phi Cards (7220 or 7240), on "regular" KNL card rigs with a regular CPU (Xeon, Core, Celeron, etc)
luk-phi-mpss-knl : For MPSS offload to x200 Phi Cards (7220 or 7240), on special builds where even the host system uses a Xeon Phi CPU (upon special request)
Note that cpu, knc, knc-native, and knc-mpss have been disabled and are no longer supported.
The miner understands the following arguments:
--algo <alg> | -a <alg> : mining algorithm to use (see below)
--host <hostname> : hostname for the pool to use
--port <port>: port of the pool to use
--user <username>: username to use on the specified pool
--pass <password>: passwrod to use on the specified pool (usually 'x')
--nicehash|-nh: enable nicehash-mode
--no-fail-on-malloc: Do not fatally terminate upon failed huge-page memory allocation. By default the miner fatally teminates to "gently remind you" to turn on huge-page support for your system. If this is not possible, use this flag to silently ignore this error (though you will get lower hashrate).
--donate <host> <port> <user> <percent>: Donate the given percentage of your hash rate to the given user name / wallet name, on the given host:port pool.
-l|--log-file <logfile> : Specify a file name where logging outputs are to go.
--simplified-logging : Enables a (additional) simplified logging method in which all logs look like a simple "LOG:field=value" that is easier to parse by automated monitoring tools.
--status-port <port> : Opens a TCP port at which it serves the latest status logs
The miner currently understands the following algorithms (via "--algo
xmr-v4r : cryptonight version 4/random, as used by monero past Mar 2019 fork.
xnalloy : 'cryptonight alloy', as used by alloy coin
xnhaven : 'cryptonight haven', as used by haven coin
xnheavy : 'cryptonight heavy', as used in Loki, Saronite, etc
Example: Running the x200 Xeon Phi miner for mining Monero on dwarfpool (after the March 2019 'v4r' fork)
./luk-phi -a xmr-v4r --host xmr-usa.dwarfpool.com --port 8080 --user 45Pw3bWFJXQiR1hN97huM6BbNPpnYdPytWnTUbkEm6KS9MExU7Gtr3nBsVoZA746qhCEwqVsFuPdwfXVtZwXxHQ6LDyfBaL --pass x
Example: Running the x200 Xeon Phi miner for mining loki on cryptoknight pool:
./luk-phi -a xnheavy --host loki.ingest.cryptoknight.cc --port 7733 --user LEc5AVn9BeME2zwrfEaKB3BHVEc8or1vMWNvk6QGDyQNefHTfuiBsFU3UfaECTD9c2gih94K9WqVQjbD9Juto1Pe225SAUn.100000
Example: Running with x200 KNL PCI cards (7220A, 7240P) using MPSS offload (for loki on loki.miner.rocks pool):
./luk-mpss-knl -a xnheavy --host loki.miner.rocks --port 5555 --user LEc5AVn9BeME2zwrfEaKB3BHVEc8or1vMWNvk6QGDyQNefHTfuiBsFU3UfaECTD9c2gih94K9WqVQjbD9Juto1Pe225SAUn.100000 --pass w=myWorkerName
Example: Running cpu miner for alloy coin:
./luk-cpu -a xnalloy --host alloy.ingest.cryptoknight.cc --port 5662 --user A6MKy9TZabKU1LFuA7J97QXVrLMnWRMmhaM6GANzpU98i5wr31zNMEN39szAUvgPfoLw1Jvm3KnAnNzpWMBZfMYZBRPGdGr --pass x
Example: Running old, x100 Xeon Phi PCI cards using MPSS offload; mining aeon on aeon-pool
./luk-mpss-knc -a aeon --host mine.aeon-pool.com --port 8080 --user Wmt5hTKURa1bzAaUroB9JQByeiK7nPooLf4KcMXBCjMfdbeoTHVWzXePHMiyGFTNVhgtzXrxn9vZTfCqKFD57oea2UV2de3Qy --pass x
Example: Running with x200 KNL PCI cards (7220A, 7240P) using MPSS offload (for haven):
./luk-mpss-knl -a xnhaven --host haven.miner.rocks --port 4005 --user hvxxwLQB2wC1dmdSzw1fyTiMUhPa438YxgrZZPsv1Tkj5tgMLpN58SDikUGfBmkJ7RXXTRAzmYALa9vMe5P55L1m3aGHQpLWcM.100000 --pass w=myWorkerName
Example: Running with x200 KNL PCI cards (7220A, 7240P) using MPSS offload (for stellite):
./luk-mpss-knl -a xnstellite --host stellite.ingest.cryptoknight.cc --port 16222 --user Se48FcbD5uWF2AVsMgDuj918yTtRDPC5H218ZsXBP6jtCpmGdDa8D97Q6f9jWWUkeK2snno9rr8CoVjU1KKh7vxP13C6xLVGx.150000 --pass 'w=myRig'
./luk-cpu -a ipbc --host tube.ingest.cryptoknight.cc --user bxcH7ypUkmt12peei8zF9ocUT92AJhxgiPi4MRotgmRaaUDa3V1uhj9ac9SQCzAVUnPeJ66HxJ9zs97ZF2MXENWj1P54GdaYh --port 5631 --pass 'w=myRig'
LukMiner comes with multiple different pre-compiled binaries; typially because either a given platofrm requires a binary that isn't compatible with other platforms (say,
-knc-native for knights corner devices won't run on a regular CPU; or x200 Phi binaries won't run on x100 Phi cards, etc); or because a binary requires additional dependencies that not everybody might have (e.g., the
-mpss binaries requires you to have a working install of the intel MPSS stack, which many machines do not have).
As such, you first have to choose the right binary from the following list:
luk-cpu : For regular CPUs: Intel Core, Intel Xeon, Intel Celeron, AMD Opteron, AMD FX, etcpp. Pretty much everything that has an x86 compatible instruction set. This binary is intentionally without any form of GPU mining, thus running even on older systems without (or with broken) GPU drivers.
luk-phi : For bootable x200 "Knights Landing" (or "Knights Mill") Xeon Phis (ie, typically the Asrock or Exxact machines that the blog talked about.
luk-mpss-knl: For MPSS offloading to the newer, x200 "Knights Landing" cards (7220 and 7240).
All all these three "offload" binaries also contain the plain cpu driver, so unless you turn CPU mining off explicitly it will automatically run on all GPUs/Phis and on the CPU.
applied new vector code also to haven. Seeing about 10% speedup, but need to use 6000 in /proc/sys/vm/nr_hugepages
significant performance boost for xmr-v4r
bugfix for running mpss miner on non-avx supporting machines
re-activated luk-cpu, and improved performance on phi
fixed crash with blockchain height 1788000
added v4r support also to mpss-knl miner. Disabled KNC and older CPU codes.
added support for '-a xmr-v4r' (Monero v4/Random as of Mar 2019).
axed deprecated opencl and cuda codes, as well as binaries for that
significant rewrite of v8 miner
Now supporting Monero v8 fork:
Now supporting 'masari' coin:
Now supporting 'stellite' coin:
Now supporting 'haven' coin:
-a xmr now points to xmr-v7 algorithm
new binary luk-phi-mpss-knl for rigs with knl cards in socketed phi mainboards
xnheavy devshare now goes to loki, on cryptoknight pool (with fixed difficulty)
pulled support for xndark algorithm; seems to me this project died.
can now specify log-file location (-l
can now specify simplified status logging, as well as a status port.
watchdog off by default
preliminary support for alloy (-a xnalloy)
some more performance for cryptonight heavy (loki / sumo)
full support for "CryptoNight Light v1" as used in Turtle
several optimizations to sumo
support for "CryptoNight Heavy" as used in Sumo v1
Various bugfixes, in particular re outputs
First support for "-a xmr-v7" for monero v7 fork (fixed in all of cpu, knc, knl, and ocl)
Lots of various bugfixes
Added support for x200 MPSS offloading; can now do both mpss offload and native mining for both x100 and x200
Added cryptonight dark (bitnote) algorithm
Reduced number of binaries via unifying miners: Rather than having different miners for different algorithm we now use a single binary and specify mining algorithm via "-a
Better documentation via auto-generated README.html; will now automatically get distributed to public releases/
Generating different releases based on dependencies: regular (cpu, opencl, phi), x100 KNC witht MPSS 3.8, and x200 phi MPSS offload (MPSS 4.4)
releases now hosted on
now have auto-booting lukSticks for cpu, phi, phi-mpss, and knc-mpss