cgminer(1) multi-threaded multi-pool GPU, FPGA and CPU bitcoin miner.


cgminer [,-DlmpPqUTouOchnV/]


multi-threaded multi-pool GPU, FPGA and CPU bitcoin miner. Built with avalon avalon2 avalon4 bflsc bitfury cointerra drillbit hashfast icarus klondike mining support.


Options for both config file and command line:

--anu-freq <arg>
Set AntminerU1/2 frequency in MHz, range 125-500 (default: 250.0)
--api-allow <arg>
Allow API access only to the given list of [G:]IP[/Prefix] addresses[/subnets]
--api-description <arg>
Description placed in the API status header, default: cgminer version
--api-groups <arg>
API one letter groups G:cmd:cmd[,P:cmd:*...] defining the cmds a groups can use
Enable API, default: disabled
Enable API Multicast listener, default: disabled
--api-mcast-addr <arg>
API Multicast listen address
--api-mcast-code <arg>
Code expected in the API Multicast message, don't use '-'
--api-mcast-des <arg>
Description appended to the API Multicast reply, default: ''
--api-mcast-port <arg>
API Multicast listen port (default: 4028)
Allow API (if enabled) to listen on/for any address, default: only
--api-port <arg>
Port number of miner API (default: 4028)
--api-host <arg>
Specify API listen address, default:
--au3-freq <arg>
Set AntminerU3 frequency in MHz, range 100-250 (default: 225.0)
--au3-volt <arg>
Set AntminerU3 voltage in mv, range 725-850, 0 to not set (default: 775)
Adjust avalon overclock frequency dynamically for best hashrate
--avalon-cutoff <arg>
Set avalon overheat cut off temperature (default: 60)
Set fanspeed percentage for avalon, single value or range (default: 20-100)
Set frequency range for avalon-auto, single value or range
--avalon-options <arg>
Set avalon options baud:miners:asic:timeout:freq:tech
--avalon-temp <arg>
Set avalon target temperature (default: 50)
Set frequency range for Avalon2, single value or range, step: 25
Set Avalon2 core voltage, in millivolts, step: 125
Set Avalon2 target fan speed
--avalon2-cutoff <arg>
Set Avalon2 overheat cut off temperature (default: 98)
Set Avalon2 fan to fixed speed
--avalon2-polling-delay <arg>
Set Avalon2 polling delay value (ms) (default: 20)
Automatic adjust voltage base on module DH
Set Avalon4 core voltage, in millivolts, step: 125
Set frequency for Avalon4, 1 to 3 values, example: 445:385:370
Set Avalon4 target fan speed range
--avalon4-temp <arg>
Set Avalon4 target temperature (default: 42)
--avalon4-cutoff <arg>
Set Avalon4 overheat cut off temperature (default: 65)
--avalon4-polling-delay <arg>
Set Avalon4 polling delay value (ms) (default: 20)
--avalon4-ntime-offset <arg>
Set Avalon4 MM ntime rolling max offset (default: 4)
--avalon4-aucspeed <arg>
Set Avalon4 AUC IIC bus speed (default: 400000)
--avalon4-aucxdelay <arg>
Set Avalon4 AUC IIC xfer read delay, 4800 ~= 1ms (default: 19200)
Change multipool strategy from failover to even share balance
--benchfile <arg>
Run cgminer in benchmark mode using a work file - produces no shares
Display each benchfile nonce found
Run cgminer in benchmark mode - produces no shares
--bflsc-overheat <arg>
Set overheat temperature where BFLSC devices throttle, 0 to disable (default: 85)
--bitburner-voltage <arg>
Set BitBurner (Avalon) core voltage, in millivolts
--bitburner-fury-voltage <arg>
Set BitBurner Fury core voltage, in millivolts
--bitburner-fury-options <arg>
Override avalon-options for BitBurner Fury boards baud:miners:asic:timeout:freq
--bxf-bits <arg>
Set max BXF/HXF bits for overclocking (default: 54)
--bxf-debug <arg>
BXF: Debug all USB I/O, > is to the board(s), < is from the board(s) (default: 0)
--bxf-temp-target <arg>
Set target temperature for BXF/HXF devices (default: 82)
--bxm-bits <arg>
Set BXM bits for overclocking (default: 54)
--btc-address <arg>
Set bitcoin target address when solo mining to bitcoind (mandatory)
--btc-sig <arg>
Set signature to add to coinbase when solo mining (optional)
Use compact display without per device statistics
--cta-load <arg>
Set load for CTA devices, 0-255 range (default: 0)
--ps-load <arg>
Set power supply load for CTA devices, 0-100 range (default: 0)
Enable debug output
Automatically disable pools that continually reject shares
--drillbit-options <arg>
Set drillbit options <int|ext>:clock[:clock_divider][:voltage]
--drillbit-auto <arg>
Enable drillbit automatic tuning <every>:[<gooderr>:<baderr>:<maxerr>]
Do not redirect to stratum protocol from GBT
--hfa-hash-clock <arg>
Set hashfast clock speed (default: 550)
--hfa-fail-drop <arg>
Set how many MHz to drop clockspeed each failure on an overlocked hashfast device (default: 10)
Set fanspeed percentage for hashfast, single value or range (default: 10-85)
--hfa-name <arg>
Set a unique name for a single hashfast device specified with --usb or the first device found
Disable hashfast dynamic core disabling feature
--hfa-options <arg>
Set hashfast options name:clock (comma separated)
--hfa-temp-overheat <arg>
Set the hashfast overheat throttling temperature (default: 95)
--hfa-temp-target <arg>
Set the hashfast target temperature (0 to disable) (default: 88)
Set the hashratio clock frequency
--hotplug <arg>
Seconds between hotplug checks (0 means never check)
--klondike-options <arg>
Set klondike options clock:temptarget
Change multipool strategy from failover to quota based balance
--log|-l <arg>
Interval in seconds between log output (default: 5)
Minimise caching of shares for low memory applications
--monitor|-m <arg>
Use custom pipe cmd for output messages
--nfu-bits <arg>
Set nanofury bits for overclocking, range 32-63 (default: 50)
Impose small delays in networking to not overload slow routers
Don't submit shares if they are detected as stale
--osm-led-mode <arg>
Set LED mode for OneStringMiner devices (default: 4)
--pass|-p <arg>
Password for bitcoin JSON-RPC server
Force verbose mode and output per-device statistics
Verbose dump of protocol-level activities
Disable logging output, display status and errors
--quota|-U <arg>
quota;URL combination for server with load-balance strategy quotas
Disable all output
--rock-freq <arg>
Set RockMiner frequency in MHz, range 125-500 (default: 270.0)
--rotate <arg>
Change multipool strategy from failover to regularly rotate at N minutes
Change multipool strategy from failover to round robin on failure
Set a time of day in HH:MM to start mining (a once off without a stop time)
Set a time of day in HH:MM to stop mining (will quit without a start time)
Append share log to file
--shares <arg>
Quit after mining N shares (default: unlimited)
--socks-proxy <arg>
Set socks4 proxy (host:port)
--suggest-diff <arg>
Suggest miner difficulty for pool to user (default: none)
Use system log for output messages (default: standard error)
Temperature where a device will be automatically disabled, one value or comma separated list (default: 0)
Disable ncurses formatted screen output
--url|-o <arg>
URL for bitcoin JSON-RPC server
--usb <arg>
USB device selection
--user|-u <arg>
Username for bitcoin JSON-RPC server
--userpass|-O <arg>
Username:Password pair for bitcoin JSON-RPC server
Log verbose output to stderr as well as status output
Use extra wide display without toggling
Display extra work time debug information

Options for command line only:

--config|-c <arg>
Load a JSON-format configuration file See example.conf for an example configuration.
--default-config <arg>
Specify the filename of the default config file Loaded at start and used when saving without a name.
Print this message
Display all USB devices and exit
Display version and exit