NBMiner - command line arguments and options

6 minute read

Instructions for setting up a batch file. Guide on how to use the program. nbminer

Download

Download here

Using .bat file:

nbminer -a algo -o protocol+socket_type://pool_host:pool_port -u wallet_address.worker:passwd

LHR unlock options

  • --lhr <modes> - partial unlock hashrate for Nvidia LHR GPUs.

Available Values: [-1, 100]. 0: auto, -1: off.

Notice: set to 80 means tryiung to reach 80% of nonlocked max hashrate.

Example LHR mode for ETH with ethermine:

nbminer -a ethash -o eu1.ethermine.org:4444 -u 0x3aa3e06C47caDEf96202D378aB7C407CF46A36A4.rig --lhr 80
pause

 

  • --lhr-mode, --lm <modes> - LHR unlock mode for Nvidia LHR GPUs.

Available Values: 1 or 2.
1: higher max hashrate, higher power consumption;
2: lower max hashrate, lower average power consumption.

Example:

nbminer -a ethash -o eu1.ethermine.org:4444 -u 0x3aa3e06C47caDEf96202D378aB7C407CF46A36A4.rig --lhr-mode 1
pause

 

  • --lhr-reduce-value, --lrv <value> - The amount of -lhr valud reduced each time when GPU hits LHR lock.

  • --lhr-reduce-time, --lrt <time> - The -lhr value will reduce by -lhr-reduce-value if the time since last lock.

  • --lhr-reduce-limit, --lrl <limit> - Limit the times of -lhr been reduced.

Fee

  • --fee <fee> Change devfee in percentage, [0-5]. Set to 0 to turn off devfee with lower hashrate. Otherwise, devfee = max(set_value, default_value).

Overclock settings

Just add this parameters to the command in the .bat file you use (with the desired core clock speed - 1075-1150 work well for a RTX 3070)

It differs from your current clock as in it is dynamic and adjusted to hit the power limit you set. If you lock the core clock, it will only draw as much power needed to reach the desired core clock. For most users this results in a decrease in power draw of about 5-10W.

Power Limit

  • --power-limit, --pl <limit> - Set power limit of GPU.

Set PL in watts: --pl 200.

nbminer -a ethash -o eu1.ethermine.org:4444 -u 0x3aa3e06C47caDEf96202D378aB7C407CF46A36A4.rig --pl 200
pause

 

In the characteristics of the video card, you can see its declared power consumption. GPU power consumption is indicated in Watts. The higher the TDP, the more power is consumed by the graphics adapter in full load.

Read the guide to setting up MSI Afterburner - power limit, monitoring, core voltage on Windows.

Set PL in percetage of default PowerLimit: --pl 75%

nbminer -a ethash -o eu1.ethermine.org:4444 -u 0x3aa3e06C47caDEf96202D378aB7C407CF46A36A4.rig --pl 75%
pause

 

Absolute core clock and lock core clock

  • --cclock <clocks> - Set core clock in MHz.
    • Set clock offsets: --cclock 100, --cclock -500 (Windows only)
    • Set locked clock: --cclock @1500.
  • --mclock <clocks> - Set memory clock offsets in MHz. (Windows only)

Instead of using an offset clock and power limit (you can still apply a power limit), you can lock the Core Clock and the GPU will only draw the power needed.

Windows:

--lock-cv 1075 (you gotta fiddle around a little bit). 
  • --lock-cv <cv> - Set locked core voltages in mV. (Windows only)

You got to run .bat file as Administrator.

Linux: If you are using linux you can also use:

nvidia-smi -i 0 -lgc 1075 (where 0 is your GPU ID)

Ravos:

nvidia-smi -lgc 1050 - Change number to supported core lock range

Memory tweak

  • --mt, --memory-tweak <mode> - Memory timings optimize for Nvidia GDDR5 & GDDR5X gpus.

Available range [1-6]. Higher value equals higher hashrate.

Individual value can be set via comma seperated list. Power limit may need to be tuned up to get more hashrate.

Higher reject share ratio can happen if mining rig hits high temperature, set lower value of -mt can reduce reject ratio.

Driver install

Under windows, a custom driver need to be installed when using -mt, can installed manually by option --driver, or run nbminer.exe with admin privilege to perform auto-install.

Under linux, admin priviledge is needed to run, sudo ./nbminer -mt x.

OhGodAnETHlargementPill is not needed anymore if -mt is enabled when mining on 1080 & 1080ti GPUs.

  • --driver <action> - Windows only option, install / uninstall driver for memory tweak. Run with admin priviledge.

run as admin

install: nbminer.exe --driver install,

uninstall: nbminer.exe --driver uninstall.

Fan

  • --fan <speed> - Set GPU fan speed in percentage. (Windows only)

Pool options

  • -a, --algo <algo> - Select mining algorithm.

  • -o, --url <url> - Mining pool url.

  • -p, --password <password> - password for mining pool.

  • -p1, --password1 <password> - password for backup mining pool1.

  • -p2, --password2 <password> - password for backup mining pool2.

  • -u, --user <user> - User used in Mining pool, wallet address or username.

  • -o1, --url1 <url> - url for backup mining pool 1.

  • -u1, --user1 <user> - username for backup mining pool 1.

  • -o2, --url2 <url> - url for backup mining pool 2.

  • -u2, --user2 <user> - username for backup mining pool 2.

Temperature limit

  • --temperature-limit, --tl <temp-limit> - Set temperature limit of GPU, if exceeds, stop GPU.

  • --temperature-start, --ts <temp-start> - Set cool-down temperature target if GPU is stopped by temperature-limit, default to - 5.

GPU settings

  • -d, --devices <devices> - Specify GPU list to use. Format: -d 0,1,2,3 to use first 4 GPU.

  • --platform <platform> - Choose platform:

    • 0: NVIDIA+AMD (default),
    • 1: NVIDIA only,
    • 2: AMD only

Intensity

  • -i, --intensity <intensities> - Comma-separated list of intensities (1 -100).

Config

  • -c, --config <config file path> - Use json format config file rather than cmd line options.

  • --generate-config <filename> - Generate a sample config json file.

  • -h, --help - Displays help.

Log file options

  • --log - Generate log file named logs/log_<timestamp>.txt.

  • --log-file <filename> - Generate custom log file. Note: This option will override ``–log`.

  • --log-no-job - Set this option to disable ‘New job’ info in console and log file.

  • --log-cycle <cycle> - Set to change the cycle of Summary table show in console and log, in seconds, defaults to 30.

  • --no-health - Do not query device health status. (Do not set if use LHR gpu)

  • --no-color - Do not use colorful output log in cmd line.

  • --long-format - Use ‘yyMMdd HH:mm:ss,zzz’ for log time format.

  • --verbose - Print communication data between miner and pool in log file.

  • --device-info - Print device cuda information.

  • --device-info-json - Print out detailed information for every device in json format.

Watchdog

  • --no-watchdog - Disable watchdog process.

  • --share-check <value> - If minutes without share, reboot miner, set 0 to disable. Default: 30

  • --no-interrupt - set this option will disable miner interrupting current GPU jobs when a new job coming from pool, will cause less power supply issue, but might lead to a bit higher stale ratio and reject shares.

  • --enable-igpu - AMD igpu is disabled by default, set this option to enable.

Others

  • -v, --version - Displays version information.

  • --api <host:port> - The endpoint for serving REST API.

  • --strict-ssl - Check validity of certificate when use SSL connection.

  • --proxy - Socks5 proxy used to eastablish connection with pool, E.g. 127.0.0.1:1080

  • --cuckoo-intensity <intensity> - Set intensity of cuckoo, cuckaroo, cuckatoo, [1, 12]. Smaller value means higher CPU usage to gain more hashrate. Set to 0 means autumatically adapt. Default: 0.

API Reference

Web Monitor

Open http://api_host:port/ in your browser to use web monitor.

Request

GET http://api_host:port/api/v1/status

Response

{
"miner": {
"devices": [
	{
		"accepted_shares": 4,
		"core_clock": 1530,
		"core_utilization": 100,
		"fan": 59,
		"hashrate": "61.50 M",
		"hashrate2": "0.000 ",
		"hashrate2_raw": 0,
		"hashrate_raw": 61497708.17088159,
		"id": 0,
		"info": "NVIDIA GeForce RTX 3070",
		"invalid_shares": 0,
		"lhr": 0,
		"memTemperature": -1,
		"mem_clock": 8000,
		"mem_utilization": 100,
		"pci_bus_id": 1,
		"power": 131,
		"rejected_shares": 0,
		"temperature": 57
	},
	{
		"accepted_shares": 3,
		"core_clock": 1035,
		"core_utilization": 100,
		"fan": 80,
		"hashrate": "85.07 M",
		"hashrate2": "0.000 ",
		"hashrate2_raw": 0,
		"hashrate_raw": 85069773.34248555,
		"id": 1,
		"info": "NVIDIA GeForce RTX 3080 Ti LHR",
		"invalid_shares": 0,
		"lhr": 74,
		"memTemperature": 104,
		"mem_clock": 10251,
		"mem_utilization": 100,
		"pci_bus_id": 48,
		"power": 258,
		"rejected_shares": 0,
		"temperature": 64
	}
],
"total_hashrate": "146.6 M",
"total_hashrate2": "0.000 ",
"total_hashrate2_raw": 0,
"total_hashrate_raw": 146567481.51336715,
"total_power_consume": 389
},
"reboot_times": 0,
"start_time": 1637549633,
"stratum": {
"accepted_shares": 7,
"algorithm": "ethash",
"difficulty": "4.295 G",
"dual_mine": false,
"invalid_shares": 0,
"latency": 217,
"pool_hashrate_10m": "217.9 M",
"pool_hashrate_24h": "217.9 M",
"pool_hashrate_4h": "217.9 M",
"rejected_shares": 0,
"url": "asia2.ethermine.org:5555",
"use_ssl": true,
"user": "0x4296116d44a4a7259B52B1A756e19083e675062A"
},
"version": "40.0"
}