Guide to Command Line Mining with BFGMiner
From Multipool Wiki
Revision as of 08:16, 22 April 2018 by Nick
7 STEPS TO SETUP AND MINE WITH BFGMiner
- Download BFGMiner from the official repository https://github.com/luke-jr/bfgminer
- Be careful with prebuilt packages, spoofed addresses and corrupted mining software.
- Install, configure and build BFGMiner with the correct dependencies and driver configurations for your mining hardware (ie. CPU, GPU, ASIC, etc.) as outlined in the BFGMiners GitHub readme docs, which provides instructions for Linux, Mac OSX and Windows.
- Ensure your mining devices are properly connected and powered on.
- Open your “Terminal” on Mac OS X, Linux or “Command Prompt” in Windows.
- Open BFGMiner by executing one of the following in the command line (do not type the $ symbol):
- Open BFGMiner without any settings:
- To start up with a connection to a single pool:
$ bfgminer -o stratum+tcp://us.multipool.us:port -u workerName -p anyPassword
- Note: Connect to the “us” or “eu” server, whichever has the shortest ping response.
- Note: Replace “port” with the 4 digit Multipool.us server port specific to the currency you plan to mine.
- Note: Replace “workerName” with your Multipool.us workerName.WorkerID.
- Note: If you plan to mine a scrypt (or non SHA256) algorithm you need to include --scrypt (or --x11) in the command line, typically “$ bfgminer -- scrypt -o ...”.
- Note: For more BFGMiner command line options visit the BFGMiners GitHub readme docs.
$ bfgminer -o stratum+tcp://us.multipool.us:3333 -u workerName1 -p anyPassword -o stratum+tcp://us.multipool.us:8888 -u workerName2 -p anyPassword
- The BFGMiner status line shows:
- Pool (0, 1, ...): us.multipool.us Diff: 512 + Strtm
- LU (“Latest update” - Oldest work update currently being used for new work): [hh:mm:ss]
- User: userID.workerID
- Block: #516011: ...497312a9
- Diff (“Current network difficulty”): 3.45T (24.79E)
- Started: [hh:mm:ss]
- I (“expected income”): 0.00 BTC/hr
- The BFGMiner status line shows:
- ST (“Staged work items in queue and ready to use”): 2
- F (“network failure occasions when the server is down or slow to provide work”): 0
- NB (“new blocks detected on the network”): 9
- AS (“Active shares in the process of being submitted”): 0
- BW (“bandwidth usage on the network (received/sent)”):[ 49/ 2 B/s]
- E (“Efficiency is (# shares accepted) * (difficulty of share per 2kB of bandwidth)”): 0.00
- BS (“Best all time share difficulty found by the miner”): 0.00
- The totals line shows the following:
- Device (Displayed by processor number, 0, 1, 2, …) (“devices/processors currently hashing, hottest temperature reported by any processor”): 6/32 75.0C
- Hash Rates: 20s decaying exponentially decaying average (configurable with --log option) / all-time average hash rate / all-time effective average ): 171.3/170.8/171.2Gh/s
- A (“number of accepted shares”): 729
- R (“rejected shares+discarded stale shares(% of total rejected shares relative to total shares hashed)”): 8+0(.01%)
- HW (“number of hardware errors / % of invalid nonces returned”): 0/.81%
Pool 0: ...us.multipool.us Diff:512 +Strtm LU:[10:48:54] User:koinKangaroo.worker1
Block #516011: ...497312a9 Diff:3.46T (24.79E) Started: [10:40:23] I: 0.00 BTC/hr
ST:1 F:0 NB:1 AS:0 BW:[ 75/241 B/s] E:2.42 BS:2.71k
0 6/32 75.0C | 171.3/170.8/171.2Gh/s | A:729 R:8+0(.01%) HW:0/.81%
- Note: ”P” or “p” works the same, there is no need to hold down the shift key when selecting the following menu options.
- Note: When in configuration menus, reporting log will not be displayed. Press any key other than the active menu options to clear the menu and report to status and reporting screen.
[M]anage devices [P]ool management, [S]ettings, [D]isplay options, [H]elp and [Q]uit.
- To manage or connect the connected devices, press “M”
- Add a Device by pressing “+”
- Search for devices by entering a target. If you don't know the specific serial port address you can enter "auto" or "all", be careful as these commands can write to and affect the operation of your computers ports.
- Press “P” for pool management
- Add a Pool by pressing “A”
- Remove a Pool by pressing “R”
- Disable a Pool by pressing “D”
- Enable a Pool by pressing “E”
- Prioritize a Pool by pressing “P”
- Change management strategy by pressing “C”
Select processor to manage using up/down arrow keys
BFL 0a: 78.0C | 3.64/ 3.70/ 2.91Gh/s | A:46 R:0+0(none) HW: 2/none
BitFORCE SHA256 SC from Butterfly Labs
- Failover: The default strategy is failover. This will prioritize your mining pool list. If a pool fails it will move down the list, when a higher priority pool recovers it will move back to mining on the highest working priority pool.
- Round Robin: This strategy moves from one pool to the next when the current pool fails, but will make no other moves.
- Rotate: This strategy moves at user-defined intervals from one active pool to the next, skipping pools that are idle.
- Load Balance: This strategy sends work to all the pools on a quota basis. By default, all pools are allocated equal quotas unless specified with "--quota". This apportioning of work is based on work handed out, not shares returned so is independent of difficulty targets or rejected shares. While a pool is disabled or dead, its quota is dropped until it is re-enabled. Quotas are forward looking, so if the quota is changed on the fly, it only affects future work. If all pools are set to zero quota or all pools with quota are dead, it will revert to failover mode.
- Balance: This strategy monitors the amount of difficulty 1 shares solved for each pool and attempts do the same amount of work for each pool.
- Turn Off/On Longpool setting by pressing “L”: On
- Adjust the pool queue by pressing “Q”
- Adjust the pool scantime in seconds by pressing “S”
- Adjust the pool timeout in seconds by pressing “E”
- Adjust the number of connection retry attempts by pressing “R”
- Write the config file by pressing “W”
- Restart BFGMiner by pressing “B”
- Set to Normal reporting by pressing “N”
- Clear all reporting by pressing “C”
- Silent all reporting by pressing “S”
- Turn Debug reporting On/Off by pressing “D”
- Turn Per Device reporting On/Off by pressing “P”
- Turn Quit reporting On/Off by pressing “Q”
- Turn Verbose reporting On/Off by pressing “V”
- Turn RPC Debugging On/Off by pressing “R”
- Turn reporting worktime details On/Off by pressing “W”
- Change the summary detail level between devices, processors and X by pressing “M”
- Adjust the log interval between 5, 10, 20 and X by pressing “L”
- Adjust the statistical accounts between absolute, X and X by pressing “T”
- Zero out the statistics by pressing “Z”
- The help menu displays an acronym directory for the metadata.
- Upon quitting BFGMiner will display a summary of the sessions mining metadata.