Options can be passed as command-line flags (--flag value) or as environment variables (FORGE_FLAG) — handy for HiveOS and .bat files.
--algorithm FORGE_ALGO pearlhash, xelis, kawpow (RVN/QUAI/XNA),
cfx (aka conflux), quantus, iron
--coin FORGE_COIN KawPow coin: rvn, quai or xna (auto-detected
from the pool host if omitted; set it
explicitly for Neurai/Vipor pools)
--pool FORGE_POOL pool host:port; TLS is detected on its own (prefix
ssl:// to force it); comma-separate several pools
for fail-over
--wallet FORGE_WALLET your payout wallet address
--worker FORGE_WORKER worker / rig name shown on the pool
--password FORGE_PASS pool password (usually x)
--gpu FORGE_GPU mine only these GPU indices, e.g. --gpu 0,1,2,6
(default: all GPUs; NVIDIA first in nvidia-smi
order, then AMD in PCI bus order)
FORGE_AMD 1 = mine on the AMD cards only, 0 = on the
NVIDIA cards only (default: both)
--kernel FORGE_KERNEL Pearl on RTX 30/40: 1 (default) draws about 7% less
power for <0.5% hashrate, 2 = highest-hashrate kernel
--proxy FORGE_PROXY route every pool connection, dev fee included,
through socks5://[user:pass@]host:port
or http://[user:pass@]host:port
--tls FORGE_TLS force TLS on (--tls) or off (--tls false) for
every pool; usually not needed
FORGE_LOWVRAM low-VRAM mode for 8 GB cards on Pearl (auto by default)
Temperature protection:
--temp-limit FORGE_TEMP_LIMIT pause a card once it reaches this temperature, °C --temp-resume FORGE_TEMP_RESUME resume a paused card once it cools to this temperature, °C
Overclocking and fans (each flag takes one value applied to all GPUs, or a comma list mapped to --gpu; requires root/Administrator):
--cclk FORGE_CCLK lock GPU core clock, MHz
--coff FORGE_COFF core clock offset, MHz (+/-)
--mclk FORGE_MCLK lock memory clock, MHz
810 on GTX 10 / RTX 20 holds the memory at 810 MHz
--moff FORGE_MOFF memory clock offset, MHz (+/-)
--plimit FORGE_PLIMIT power limit, watts (Windows with AMD: % of the card's limit)
--vddoff - core voltage offset, mV (+/-): AMD RX 6000/7000/9000, NVIDIA RTX 40 on Linux
--vddc - core voltage, mV: AMD RX 5000/6000, NVIDIA RTX 20/30/50 on Linux
--voltage-info show the voltage range a card offers (with --gpu LIST)
--voltage-recover put a card's voltage back after an interrupted run
--fan FORGE_FAN fixed fan speed, %
--fan-curve FORGE_FANCURVE temp:percent points, e.g. 45:30,60:55,70:75,80:100 (NVIDIA; on AMD use --fan)
--oc-delay FORGE_OC_DELAY apply the overclock N seconds after startup
--oc-keep FORGE_OC_KEEP=1 leave the overclock on when the miner exits
--oc-reset - reset the cards to stock and exit (e.g. after a crash)
Example — per-GPU overclock on a mixed rig:
--gpu 0,1,2,6 --coff 300,250,300,200 --plimit 280,280,300,260
Put * in a list to leave that card untouched — here GPU 2 keeps its own clocks and automatic fan:
--gpu 0,1,2,6 --cclk 1500,1500,*,1500 --fan 70,70,*,70
Monitoring API, off by default and read-only: web dashboard at /, JSON at /summary, Prometheus at /metrics. On HiveOS set FORGE_API=127.0.0.1:7777 in Extra config.
--api - dashboard and API on 127.0.0.1:7777 (this machine only) --api-bind FORGE_API the same on the given address, e.g. 0.0.0.0:7777 for the LAN
Logging and display:
--log FORGE_LOG also write the output to a file (appends) --no-color, --plain FORGE_NO_COLOR ASCII output without colours (automatic without a console) --v1-tui - start in the classic scrolling view (L switches views)
CMP hardware unlock (Linux; CMP 40HX, 50HX, 70HX and 90HX; needs NVIDIA driver 610.43.03; run with sudo):
--cmp-install install the unlock helper and reboot (10 s to cancel) --no-reboot with --cmp-install: install only, reboot yourself --cmp-verify show the unlock status of each CMP card --cmp-rollback restore the previous driver from backup and reboot
--cmp-install can stay in the flight sheet for good: if the unlock is already active or the rig has no CMP cards, the miner prints one line and starts mining.
