cgminer [-DElmpPQqUSsTouOchnV]


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


Options for both config file and command line:

--anu-freq <arg>

Set AntminerU1 frequency in MHz, range 125-500 (default: 200.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:


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)


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)

--bet-clk <arg>

Set Block Erupter clock (default: 0)

--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>]

--expiry|-E <arg>

Upper bound on how many seconds after getting work we consider a share from it stale (default: 120)


Don't leak work to backup pools when primary pool is lagging


Do not redirect to a different getwork protocol (eg. stratum)

--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 (default: 280)

--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

--queue|-Q <arg>

Maximum number of work items to have queued (default: 1)


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


Serial port to probe for Serial FPGA Mining device

--scan-time|-s <arg>

Upper bound on time spent scanning current work, in seconds (default: -1)


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