bfgminer
TLDR
Mine Bitcoin using a pool with username and password
SYNOPSIS
bfgminer [-DdEgIKklLmpPQqUSsTouvwOchV] [-o url] [-u user] [-p pass]
DESCRIPTION
bfgminer is a modular multi-threaded miner written in C, designed for mining Bitcoin and other SHA256d or scrypt-based cryptocurrencies. It supports a wide range of hardware including ASICs, FPGAs, GPUs, and CPUs.
The miner connects to mining pools using the stratum protocol or JSON-RPC and submits proof-of-work solutions. It features automatic detection and configuration of supported mining devices, dynamic clocking, monitoring, and fan speed control for compatible hardware.
BFGMiner provides a built-in API for remote monitoring and control, making it suitable for managing mining rigs. It supports multiple simultaneous pools with configurable failover and load-balancing strategies.
PARAMETERS
-o, --url URL
URL for bitcoin JSON-RPC server (pool address)-u, --user USERNAME
Username for JSON-RPC server-p, --pass PASSWORD
Password for JSON-RPC server-O, --userpass USER:PASS
Username:password pair for server-d, --device PATTERN
Enable devices matching pattern (use -d? to list)-I, --intensity VALUE
Intensity of GPU scanning (-10 to 20, default: d for desktop interactivity)--scrypt
Use scrypt algorithm instead of SHA256d-c, --config FILE
Load a JSON-formatted configuration file-l, --log INTERVAL
Interval in seconds between log output-L, --log-file FILE
Append log output to this file-T, --text-only
Disable ncurses formatted screen output-q, --quiet
Disable logging output, display status and errors--api-listen
Enable API (default: disabled)--api-port PORT
Port for API (default: 4028)--api-allow [G:]IP[/PREFIX]
Allow API access only to specified addresses--failover-only
Do not leak work to backup pools in multi-pool setups-U, --quota VALUE
Load-balance quota for pool (e.g., 2:http://pool)--benchmark
Run in offline benchmark mode--shares NUMBER
Quit after mining specified number of shares-V, --version
Display version and exit-h, --help
Display help message and exit
CAVEATS
GPU mining for Bitcoin is no longer profitable due to the dominance of ASIC miners. BFGMiner's GPU support is primarily useful for scrypt-based coins or testing. The software requires appropriate drivers for your mining hardware. ASIC and FPGA devices may need specific firmware. Running mining software significantly increases power consumption and heat output.
HISTORY
BFGMiner was forked from CGMiner in 2012 by Luke Dashjr to focus on FPGA and ASIC support while maintaining modularity. The name stands for "Bitcoin Fan Guy Miner" (a reference to the developer's involvement in mining hardware cooling solutions). It became popular for its extensive hardware support and remote API capabilities. Development continues on GitHub with support for modern mining hardware.


