Flags & tuningФлаги и тюнинг
Every knob, one reference.
Все настройки в одном месте.
Anything you pass on the command line has an FORGE_* environment-variable twin — handy for HiveOS extra-config and .bat files. Overclock and fans can be one value for all cards, or a comma list mapped to --gpu.
У любого флага командной строки есть двойник-переменная FORGE_* — удобно для extra-config в HiveOS и .bat. Разгон и кулеры — одно значение на все карты или список через запятую под --gpu.
CoreОсновные
| Flag | Env | DescriptionОписание |
--algorithm | FORGE_ALGO | Algorithm: pearlhash, qhash, kawpow, cryptix, btx, xelis or cfx.Алгоритм: pearlhash, qhash, kawpow, cryptix, btx, xelis или cfx. |
--coin | FORGE_COIN | KawPow coin: rvn, quai or xna — auto-detected from the pool if omitted (set explicitly for Neurai/Vipor).Монета KawPow: rvn, quai или xna — определяется по пулу, если не задана (для Neurai/Vipor указывать явно). |
--pool | FORGE_POOL | Pool as host:port. TLS is detected automatically (ssl:// also accepted); list several for fail-over.Пул как host:port. TLS определяется автоматически (ssl:// тоже принимается); можно перечислить несколько для failover. |
--wallet | FORGE_WALLET | Your payout wallet address.Адрес кошелька для выплат. |
--worker | FORGE_WORKER | Worker / rig name shown on the pool.Имя воркера/рига на пуле. |
--password | FORGE_PASS | Pool password (usually x).Пароль пула (обычно x). |
--proto | FORGE_PROTO | Pearl dialect: stratum (HeroMiners, LuckyPool, Kryptex) or alpha (AlphaPool).Диалект Pearl: stratum (HeroMiners, LuckyPool, Kryptex) или alpha (AlphaPool). |
--gpu | FORGE_GPU | Mine only these indices, e.g. 0,1,2,6 (match nvidia-smi order). Default: all.Майнить только эти индексы, напр. 0,1,2,6 (порядок nvidia-smi). По умолчанию — все. |
| — | FORGE_LOWVRAM | Low-VRAM mode for 8 GB cards (Pearl). 1 on, 0 off. Auto by default.Режим low-VRAM для 8 ГБ карт (Pearl). 1 вкл, 0 выкл. По умолчанию авто. |
OverclockРазгон
ForgeMiner is core-clock bound and memory-light — push the core high, leave memory low. Overclocking needs root (Linux/HiveOS) or Administrator (Windows).
ForgeMiner упирается в частоту ядра и нетребователен к памяти — поднимайте ядро, память можно оставить низкой. Разгон требует root (Linux/HiveOS) или Администратора (Windows).
| Flag | Env | DescriptionОписание |
--cclk | FORGE_CCLK | Lock GPU core clock (MHz).Зафиксировать частоту ядра (МГц). |
--coff | FORGE_COFF | Core clock offset (MHz, +/−).Оффсет ядра (МГц, +/−). |
--mclk | FORGE_MCLK | Lock memory clock (MHz).Зафиксировать частоту памяти (МГц). |
--moff | FORGE_MOFF | Memory clock offset (MHz, +/−).Оффсет памяти (МГц, +/−). |
--plimit | FORGE_PLIMIT | Power limit (Watts).Лимит мощности (Вт). |
# per-GPU: values map to --gpu order
--gpu 0,1,2,6 --coff 300,250,300,200 --plimit 280,280,300,260
Fan controlУправление кулерами
A fixed speed, or a temperature curve. With no fan flag the driver keeps automatic control; it's restored on exit. Setting fans needs Administrator/root. GeForce cards have a ~30% hardware fan floor.
Фиксированная скорость или температурная кривая. Без флага — автоматика драйвера; она восстанавливается при выходе. Управление требует Администратора/root. У GeForce есть аппаратный порог ~30%.
# fixed speed
--fan 70 every GPU at 70%
--fan 60,70,80,100 per-GPU (maps to --gpu order)
# temperature curve — temp°C:fan% (linear between points)
--fan-curve 45:30,60:55,70:75,80:100
# ≤45°C→30% · 60°C→55% · 70°C→75% · ≥80°C→100% · 65°C→~65%
ReliabilityНадёжность
--temp-limit / --temp-resume pause a card automatically once it hits a temperature threshold, and resume it once it cools back down. --oc-delay delays applying your overclock by N seconds after startup, for rigs where clocking straight from boot causes instability.
--temp-limit / --temp-resume сами ставят карту на паузу при перегреве и возобновляют майнинг после остывания. --oc-delay откладывает применение разгона на N секунд после старта — для ригов, где мгновенный разгон сразу после загрузки вызывает нестабильность.
# pause at 80°C, resume at 70°C; apply overclock 20s after startup
--temp-limit 80 --temp-resume 70 --oc-delay 20
CMP hardware unlock (Linux)Аппаратный разлок CMP (Linux)
CMP 40HX, 50HX, 70HX and 90HX ship with a hardware throttle — stock hashrate is a small fraction of what the chip can actually do. Forge can install a hardware-unlock helper directly on the rig: one command, one reboot, the card then runs at full speed. The helper is embedded in the miner binary; no external download, no manual steps. Everything is reversible via --cmp-rollback. Only the detected CMP cards are touched; every other card on a mixed rig runs untouched. CMP 30HX is detected but never attempted — a permanent hardware limitation, not a bug.
CMP 40HX, 50HX, 70HX и 90HX с завода задушены аппаратно — стоковый хешрейт составляет лишь малую долю того, на что способен чип. Форж умеет поставить хелпер разлока прямо на риге: одна команда, одна перезагрузка, карта работает на полной скорости. Хелпер встроен в бинарь; ничего внешнего скачивать не нужно. Всё обратимо через --cmp-rollback. Затрагивает только обнаруженные CMP-карты; остальные работают без изменений. CMP 30HX обнаруживается, но никогда не трогается — постоянное аппаратное ограничение, не баг.
Builds from source for whatever kernel the rig is actually running — no exact kernel pin, tested clean across 10 different kernel versions. NVIDIA driver 610.43.03 still required. Full walkthrough — wiki · CMP hardware unlock (Русский).
Собирается из исходников под то ядро, что реально стоит на риге — точная привязка ядра больше не нужна, протестировано без единого сбоя на 10 разных версиях ядра. Драйвер NVIDIA 610.43.03 по-прежнему обязателен. Полная инструкция — wiki · CMP аппаратный разлок (English).
| Flag | What it doesЧто делает |
--cmp-install | Install the hardware unlock helper, reboot the rig after a 10-second cancel window. Safe to leave in the HiveOS flight sheet permanently — if the unlock is already active forge prints one line and drops straight into mining, so no reinstall loop.Установить хелпер разлока, ребут через 10-секундный обратный отсчёт. Можно оставить в полётнике HiveOS навсегда — если разлок уже стоит, форж напечатает одну строку и сразу идёт майнить, без цикла переустановок. |
--cmp-install --no-reboot | Install only — you reboot the rig yourself.Только установить — ребут делаете сами. |
--cmp-verify | Print live per-card unlock status. On CMP 40HX/50HX the register is walled off by the driver — live status is the miner's hashrate.Показать живой статус разлока по картам. На CMP 40HX/50HX регистр закрыт драйвером — живой источник правды — хешрейт майнера. |
--cmp-rollback | Restore the previous NVIDIA driver from backup and reboot (10-second cancel window). Add --no-reboot to reboot yourself.Восстановить предыдущий NVIDIA-драйвер из бэкапа и ребут (10 секунд на отмену). Добавьте --no-reboot, чтобы ребутнуться самому. |
Output (since 1.5.15)Вывод (с 1.5.15)
When stdout is not a live terminal (PSEXEC, | cat, cron, log file, web console) forge auto-strips ANSI colours and swaps Unicode box-drawing chars for ASCII — no more räć mojibake in Windows cmd or rental-platform log captures. Interactive terminals (Windows Terminal, PowerShell 7, HiveOS ssh, tmux) still get the full dashboard.
Когда stdout не живой терминал (PSEXEC, | cat, cron, лог-файл, web-консоль), форж сам вычищает ANSI-цвета и меняет Unicode box-drawing на ASCII — больше нет каши типа räć в Windows cmd или в логах rental-платформ. Интерактивные терминалы (Windows Terminal, PowerShell 7, HiveOS ssh, tmux) как раньше получают полный дашборд.
| Flag | Env | DescriptionОписание |
--no-color / --plain | NO_COLOR=1
FORGE_NO_COLOR=1 | Force plain-ASCII output. Only needed if the auto-detect gets it wrong for your setup.Принудительно plain-ASCII вывод. Нужен только если автодетект ошибся под ваш сетап. |
Monitoring APIAPI мониторинга
Off by default, read-only, one port. It only ever reports stats — it can't control or reconfigure the miner. Keep 127.0.0.1 for local-only; use 0.0.0.0 only behind your own router/firewall/VPN.
Выключен по умолчанию, только чтение, один порт. Только отдаёт статистику — управлять майнером через него нельзя. Оставляйте 127.0.0.1 для локального доступа; 0.0.0.0 — только за своим роутером/файрволом/VPN.
--api on 127.0.0.1:7777 (this machine only)
--api-bind 0.0.0.0:7777 watch from your phone / another PC on the LAN
| Endpoint | Format | Use withДля чего |
GET / | HTML | The web dashboard (alias /dashboard).Веб-дашборд (алиас /dashboard). |
GET /summary | JSON | Grafana, bots, scripts — total + per-GPU everything, plus a short history for graphs.Grafana, боты, скрипты — всё по картам и суммарно, плюс короткая история для графиков. |
GET /metrics | Prometheus | Grafana dashboards and alerts (forge_hashrate_hs, …).Дашборды и алерты Grafana (forge_hashrate_hs, …). |
miner_getstat1 | Claymore | Awesome Miner, mmpOS — add forge with the Claymore/Ethminer API on port 7777.Awesome Miner, mmpOS — добавьте forge через Claymore/Ethminer API на порту 7777. |