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:
http://www.lukminer.com: The "official" Wordpress blog I use for distributing lukMiner-related news and updates
http://www.lukminer.net/releases: Latest releases for the miner
http://sites.google.com/site/lukxmrminer: The "original" google site with some more general information on the miner.
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)
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-v8 : monero v8 algorithm, as will be used by monero after the Oct 2018 hard-fork
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
xnstellite : 'cryptonight stellite', as used by stellite coin
xnmasari : 'cryptonight masari', as used by masari coin
xnhaven : 'cryptonight haven', as used by haven coin
Example: Running the CPU miner for mining Monero on dwarfpool (after the Apr 6, 2018 'v7' fork)
./luk-cpu -a xmrv8 --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 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-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-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).
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.
axed deprecated opencl and cuda codes, as well as binaries for that
significant rewrite of v8 miner. First speedups (15-20%) for v8 on KNLs
first attempt to rewrite v8 - abandoned.
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