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-cpu : for cpu-only mining
luk-phi : for mining on 'bootable' x200 Xeon Phi nodes
luk-knc-native : for running natively x100 Phi cards (7120, 31s1p, etc)
luk-mpss-knc : for MPSS offload to x100 Phi Cards (7120, 31s1p, etc)
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)
luk-ocl : For mining on OpenCL-capable GPUs.
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 currnetly understands the following algorithms (via "--algo
xmr : monero v7 algorithm, as will be used by monero after the march 2018 hard-fork
xnclassic : classic 'cryptonight' algorithm, as used in ETN, and (pre-fork) Monero
aeon : 'cryptonight light' algorithm; as used in Aeon coin.
trtl : 'cryptonight light v1' algorithm; as used in TRTL coin
xndark : 'cryptonight dark', as used in Bitnote coin (XBN)
xnheavy : 'cryptonight heavy', as used in Loki, Saronite, etc
xnalloy : 'cryptonight alloy', as used by alloy coin
Example: Running the CPU miner for mining Monero on dwarfpool (after the Apr 6, 2018 'v7' fork)
./luk-cpu -a xmr --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 w=myWorkerName
Example: Running cpu miner for turtle (TRTL) coin:
./luk-cpu -a trtl --host trtl.pool.mine2gether.com --port 6665 --user TRTLv1uvD2YdjbXjCtfkgLZLMbWVvJFD39hSJC3PPHHdJadVuni1myWVFx6KzZ8YRmAAQh6Uq8amyVzm533KzHBA8quAddENG1D --pass x
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-knc-mpss -a aeon --host mine.aeon-pool.com --port 8080 --user Wmt5hTKURa1bzAaUroB9JQByeiK7nPooLf4KcMXBCjMfdbeoTHVWzXePHMiyGFTNVhgtzXrxn9vZTfCqKFD57oea2UV2de3Qy --pass x
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
-ocl binary requires you to have a working install of opencl, 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-knc-native : For the older, x100 "Knights Corner" Xeon Phis that you intend to run in "native mode"; i.e., where you manually copy the binary to the device, and run it there (most commonly this is only for advanced KNC users - if you're not a "Ninja" KNC user, use the
luk-mpss-knc : For MPSS offloading to the older, x100 "Knights Corner" Xeon Phis (7120, 31s1p, 5110, etc).
luk-mpss-knl : For MPSS offloading to the newer, x200 "Knights Landing" cards (7220 and 7240).
luk-ocl : For systems that contain OpenCL-capable GPUs (both NVidia and AMD).
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.
'-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