ForgeMiner

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 11 Open GitHub ↗

Scalable multi-algo cryptocurrency miner optimized specifically for Nvidia GPUs.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">ForgeMiner</h1>

A fast, native NVIDIA GPU miner — Pearl (PRL), QubitCoin (QTC), KawPow (Ravencoin, Quai, Neurai), Cryptix (CYTX), BTX (btx.dev) and Xelis (XEL)

---

## Contents

- [Overview](#overview)
- [Download](#download)
- [Quick start](#quick-start)
- [Coins & dev fee](#coins--dev-fee)
- [Performance](#performance)
- [Features](#features)
- [Options](#options)
- [Monitoring API](#monitoring-api)
- [CMP hardware unlock (Linux)](#cmp-hardware-unlock-linux)
- [Supported GPUs](#supported-gpus)
- [Resources](#resources)

---

## Overview

ForgeMiner is a high-performance, fully native NVIDIA GPU miner. It talks to the GPU directly through the CUDA Driver API — no Python, no WSL, no extra runtimes — so it starts instantly and runs lean even on low-spec rigs. It mines **Pearl (PRL)**, **QubitCoin (QTC)**, **KawPow** (Ravencoin RVN, Quai QUAI, Neurai XNA), **Cryptix (CYTX)**, **BTX (btx.dev)** and **Xelis (XEL)** from a single binary — pick the coin with one flag — and more coins are on the way.

Every algorithm ships a separate per-architecture build for each supported card, auto-selected at launch, so each GPU runs at its peak. Rigs with CMP 50HX or CMP 90HX get built-in hardware unlock on Linux via one command — see [CMP hardware unlock](#cmp-hardware-unlock-linux).

Website: **[forgeminer.org](https://forgeminer.org)** · ForgeMiner is closed-source; releases are published here and announced on [Telegram](https://t.me/ForgeMiner) and [Discord](https://discord.gg/CyU6ASQWSy).

---

## Download

Grab the latest build from the [**Releases**](https://github.com/0xHashRaptor/ForgeMiner/releases) page:

| Platform | Package |
|---|---|
| Windows | `ForgeMiner-<version>-windows.zip` |
| Linux | `ForgeMiner-<version>-linux.tar.gz` (glibc 2.17+) |
| HiveOS | `ForgeMiner-<version>.tar.gz` (flight-sheet install URL) |
| Docker | `docker pull hashraptor/forge` (tags `:latest` and the version) |

---

## Quick start

### Windows
1. Download and unpack the Windows release.
2. Open the `.bat` for your coin/pool/region and set your wallet and worker. Files are named `<algo>_<pool>_<region>.bat` (`_SSL` = encrypted). One per coin:
 - Pearl — `pearlhash_Kryptex_Global.bat`, `pearlhash_Kryptex_EU.bat`, `pearlhash_Kryptex_RU.bat`
 - QubitCoin — `qhash_LuckyPool_RU.bat`, `qhash_LuckyPool_CA.bat`, `qhash_k1pool_EU.bat`
 - KawPow · RVN — `kawpow_RVN_Kryptex_Global.bat`, `kawpow_RVN_Kryptex_EU.bat`, `kawpow_RVN_Kryptex_RU.bat`
 - KawPow · QUAI — `kawpow_QUAI_Kryptex_Global.bat`, `kawpow_QUAI_Kryptex_EU.bat`, `kawpow_QUAI_Kryptex_RU.bat`
 - KawPow · XNA — `kawpow_XNA_Kryptex_Global.bat`, `kawpow_XNA_Kryptex_EU.bat`, `kawpow_XNA_Kryptex_RU.bat`
 - Cryptix — `cryptix_Baikalmine_Global.bat`, `cryptix_CryptixNetwork_Global.bat`
 - BTX — `btx_lproute_EU.bat`, `btx_lproute_RU.bat`
 - Xelis — `xelis_XEL_Kryptex_Global.bat`, `xelis_XEL_Kryptex_RU.bat`
3. Double-click to start. Run as Administrator to apply the built-in overclock.

### Linux
```bash
chmod +x forge
# Pearl
./forge --algorithm pearlhash --wallet YOUR_PRL_WALLET --pool prl.kryptex.network:7048 --worker rig01
# QubitCoin
./forge --algorithm qhash --wallet YOUR_QTC_WALLET --pool ru.luckypool.io:8610 --worker rig01
# KawPow — RVN / QUAI (coin auto-detected from the pool) or XNA (set --coin xna)
./forge --algorithm kawpow --wallet YOUR_RVN_WALLET --pool rvn.kryptex.network:7031 --worker rig01
# Cryptix
./forge --algorithm cryptix --wallet YOUR_CYTX_WALLET --pool cytx.baikalmine.com:9010 --worker rig01
# BTX
./forge --algorithm btx --wallet YOUR_BTX_WALLET --pool btx-eu.lproute.com:8660 --worker rig01
# Xelis
./forge --algorithm xelis --wallet YOUR_XEL_WALLET --pool xel.kryptex.network:7019 --worker rig01
```

The Linux binary is built against **glibc 2.17**, so it runs on anything from CentOS 7 / Ubuntu 14.04 upwards — no CUDA toolkit, no extra libraries, just the NVIDIA driver. Add `--api-bind 0.0.0.0:7777` to any of the commands above and open `http://<rig>:7777` for the built-in dashboard.

### Docker
```bash
docker pull hashraptor/forge
docker run --rm --gpus all hashraptor/forge \
  --algorithm pearlhash --wallet YOUR_PRL_WALLET --worker rig01 --pool prl.kryptex.network:7048
# dashboard: add -p 7777:7777 and --api-bind 0.0.0.0:7777
```

### HiveOS
Custom miner flight sheet — installation URL `.../ForgeMiner-<version>.tar.gz`, wallet template `%WAL%.%WORKER_NAME%`.

*Extra config* accepts **both** forms, one per line, and you can mix them:

```
FORGE_ALGO=xelis            # or pearlhash / qhash / kawpow / cryptix / btx
FORGE_COIN=xna              # KawPow only: rvn | quai | xna
--gpu 0,1,3                 # mine only these cards
--cclk 1500 --moff 1000     # overclock: also --coff / --mclk / --plimit
--fan 70                    # or --fan-curve 45:30,60:55,70:75,80:100
--cmp-install               # unlock any CMP 50HX / 90HX on the rig (safe to leave in permanently)
```

Hashrate, temperatures and shares appear in the HiveOS dashboard on their own — no extra flag needed. Add `--api-bind 0.0.0.0:7777` only if you also want the miner's own web dashboard.

Ready-made flight sheets: **[forgeminer.org/#flightsheets](https://forgeminer.org/#flightsheets)**.

---

## Coins & dev fee

| Coin | `--algorithm` | Pools (ready-made `.bat` in the release) | Dev fee |
|------|---------------|-------------------------------------------|:------:|
| Pearl (PRL) | `pearlhash` | Kryptex · BaikalMine · HeroMiners · LuckyPool · 2Miners · AlphaPool | 2% |
| Cryptix (CYTX) | `cryptix` | BaikalMine · CryptixNetwork | 2% |
| QubitCoin (QTC) | `qhash` | LuckyPool · k1pool | 1% |
| BTX (btx.dev) | `btx` | LuckyPool (lproute) | 1% |
| Xelis (XEL) | `xelis` | Kryptex · HeroMiners | 1% |
| Ravencoin (RVN) | `kawpow` | Kryptex · HeroMiners · 2Miners · RavenMiner · k1pool | 0.7% |
| Quai (QUAI) | `kawpow` `--coin quai` | Kryptex · HeroMiners · k1pool | 0.7% |
| Neurai (XNA) | `kawpow` `--coin xna` | Kryptex · 2Miners · Vipor | 0.7% |

The dev fee is interleaved (no graph dips) and verifiable on your pool. No hidden second fee. *More algorithms are on the way.*

---

## Performance

Pearl hashrate per GPU — **community-verified, varies with overclock and power limit**:

| GPU | Pearl (PearlHash) |
|-----|:-----------------:|
| RTX 5080 | ~219 TH/s |
| RTX 4070 Ti | ~139 TH/s |
| RTX 3060 Ti | ~52 TH/s |
| P106-100 | ~4 TH/s |

CMP 90HX / 50HX can be unlocked with the built-in `--cmp-install` on Linux — see [below](#cmp-hardware-unlock-linux). KawPow on the P104-100 runs at about **11.5 MH/s** per card. Post your own numbers in [Telegram](https://t.me/ForgeMinerChat) or [Discord](https://discord.gg/CyU6ASQWSy) — the table grows with the community.

---

## Features

- **Multiple coins, one binary** — Pearl, QubitCoin, KawPow (RVN / QUAI / XNA), Cryptix, BTX or Xelis; select with `--algorithm`.
- **Architecture-tuned kernels** — a dedicated kernel per GPU generation (Pascal / Volta / Turing / Ampere / Ada / Blackwell), auto-selected at launch.
- **CMP 50HX + 90HX hardware unlock (Linux)** — one embedded command unlocks both cards from the stock throttled hashrate to full speed (roughly 20× higher); no external scripts.
- **Native and lightweight** — direct CUDA Driver API, near-zero CPU load; no Python, WSL or extra runtimes. Starts in a second, runs on weak hosts and many-GPU boxes.
- **Efficient on crowded rigs** — keeps the GPUs fed even with many cards on a weak CPU, several miner instances, or slow x1 risers.
- **One self-contained binary** — everything embedded; no CUDA runtime or loose kernel files to manage. Even KawPow ships as a single executable.
- **Built-in overclocking & fan control** — lock clocks, apply offsets, set a power limit and drive fans straight from the miner — a different OC per card on mixed rigs. No third-party tool.
- **Multi-pool with fail-over** — standard Stratum for every coin, SSL/TLS pools, automatic reconnect and pool fail-over.
- **Live dashboard & read-only API** — per-GPU hashrate, temps (incl. VRAM on Windows), clocks, fans, power and shares — plus JSON, Prometheus and Claymore-compatible endpoints.
- **HiveOS ready** — drops straight into a custom-miner slot.

---

## Options

Anything you pass on the command line has an `FORGE_*` environment-variable twin — handy for HiveOS *Extra config* and `.bat` files.

| Flag | Env | Description |
|------|-----|-------------|
| `--algorithm` | `FORGE_ALGO` | `pearlhash`, `qhash`, `kawpow`, `cryptix`, `btx` or `xelis`. |
| `--coin` | `FORGE_COIN` | KawPow coin: `rvn`, `quai` or `xna` (auto-detected from the pool; set explicitly for Neurai / Vipor). |
| `--pool` | `FORGE_POOL` | Pool `host:port`. SSL/TLS supported; list several for fail-over. |
| `--wallet` | `FORGE_WALLET` | Payout wallet address. |
| `--worker` | `FORGE_WORKER` | Worker / rig name. |
| `--password` | `FORGE_PASS` | Pool password (usually `x`). |
| `--proto` | `FORGE_PROTO` | Pearl dialect: `stratum` or `alpha` (AlphaPool). |
| `--gpu` | `FORGE_GPU` | Mine only these indices, e.g. `0,1,2,6` (`nvidia-smi` order). |
| `--cmp-install` | — | Linux: install hardware unlock for CMP 50HX / 90HX (see [below](#cmp-hardware-unlock-linux)). |
| `--cmp-verify` | — | Linux: print live unlock status per CMP card. |
| `--cmp-rollback` | — | Linux: undo the unlock, restore the previous driver. |
| — | `FORGE_LOWVRAM` | Low-VRAM mode for 8 GB cards (Pearl). Auto by default. |

<details>
<summary>Overclocking &amp; fan control</summary>

> ForgeMiner is core-clock bound and memory-light — push the core high, leave memory low. Overclocking needs root (Linux/HiveOS) or Administrator (Windows). Each flag takes one value, or a comma list mapped to `--gpu`.

| Flag | Env | Description |
|------|-----|-------------|
| `--cclk` | `FORGE_CCLK` | Lock 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). |
| `--fan` | `FORGE_FAN` | Fixed fan speed (%). |
| `--fan-curve` | `FORGE_FANCURVE` | Temperature→speed curve, e.g. `45:30,60:55,70:75,80:100`. |

```text
# per-GPU (values map to --gpu order)
--gpu 0,1,2,6 --coff 300,250,300,200 --plimit 280,280,300,260
```
GeForce cards have a ~30% hardware fan floor; the driver's automatic control is restored on exit.
</details>

---

## Monitoring API

Off by default and **read-only** — it only reports stats, it can never control or reconfigure the miner.

```text
--api                    on 127.0.0.1:7777 (this machine only)
--api-bind 0.0.0.0:7777  on the LAN (watch from your phone / another PC)
```
On HiveOS set `FORGE_API=127.0.0.1:7777` in *Extra config*.

| Endpoint | Format | Use with |
|---|---|---|
| `GET /` | HTML | The web dashboard (total + per-GPU hashrate, temps, VRAM temp, clocks, fans, power, shares, live graph; dark/light theme). |
| `GET /summary` | JSON | Grafana, bots, custom dashboards. |
| `GET /metrics` | Prometheus | Grafana dashboards and alerts. |
| `miner_getstat1` | Claymore | Awesome Miner, mmpOS and the wider monitoring ecosystem. |

> Keep the default `127.0.0.1` for local-only access; use `0.0.0.0` only behind your own router / firewall / VPN.

---

## CMP hardware unlock (Linux)

CMP 50HX and CMP 90HX ship with a hardware throttle that keeps their hashrate at 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, both cards then run at full speed (roughly **20× higher** than the stock throttled hashrate). The helper is embedded in the miner binary; no external download, no manual steps.

Requires Linux kernel `6.10.0-hiveos` with NVIDIA driver `610.43.03`. To get that combination — HiveOS beta image `0.6-229-beta-jammy@241231` (Dec 30 2024) ships with 6.10.14-hiveos built in, then the driver goes on top:
```bash
# If uname -r isn't 6.10.0-hiveos yet — reflash first (reinstalls the OS; rig.conf preserved, local packages wiped):
sudo hive-replace -y "https://download.hiveos.farm/history/hiveos-0.6-229-beta-jammy@241231.img.xz"

# After the reboot, upgrade the driver to the exact version:
sudo nvidia-driver-update --force 610.43.03
sudo reboot
```
Only CMP 50HX and 90HX are touched; every other card on a mixed rig runs untouched. Full walkthrough (verification, GRUB pitfalls, rollback): **[wiki · CMP hardware unlock](https://github.com/0xHashRaptor/ForgeMiner/wiki/CMP-unlock)**.

| Command | What it does |
|---|---|
| `sudo forge --cmp-install` | install unlock helper, reboot with 10-second cancel window |
| `sudo forge --cmp-install --no-reboot` | install only, you reboot the rig yourself |
| `sudo forge --cmp-verify` | print live unlock status per CMP card |
| `sudo forge --cmp-rollback` | restore the previous driver from backup, reboot |

Safe to leave `--cmp-install` at the end of the flight-sheet command line permanently — if the unlock is already active forge prints one line and drops straight into mining. Full guide (kernel/driver install, exit codes, FAQ): **[wiki · CMP hardware unlock](https://github.com/0xHashRaptor/ForgeMiner/wiki/CMP-unlock)**.

---

## Supported GPUs

Kernels are tuned per architecture, so a whole generation is covered — desktop and laptop alike.

| Generation | Cards |
|---|---|
| **Blackwell** (RTX 50) | 5090 · 5080 · 5070 Ti · 5070 · 5060 Ti · 5060 · 50-series Laptop |
| **Ada** (RTX 40) | 4090 · 4080 (S) · 4070 Ti (S) · 4070 (S) · 4060 Ti · 4060 · 40-series Laptop |
| **Ampere** (RTX 30) | 3090 Ti · 3090 · 3080 Ti · 3080 · 3070 Ti · 3070 · 3060 Ti · 3060 · 30-series Laptop |
| **Turing** (RTX 20) | 2080 Ti · 2080 (S) · 2070 (S) · 2060 (S) · 20-series Laptop *(driver 545+)* |
| **Volta** | Tesla V100 |
| **Pascal** | GTX 10-series · P104-100 · P106 · P108 (8 GB mining cards) |
| **CMP** | 170HX · 90HX · 50HX · 40HX · 30HX *(driver 545+)*. 50HX and 90HX get built-in [hardware unlock](#cmp-hardware-unlock-linux) on Linux. |

*All coins run on every listed generation.*

---

## Resources

- **Website:** [forgeminer.org](https://forgeminer.org)
- **Releases & news:** [t.me/ForgeMiner](https://t.me/ForgeMiner)
- **Support & chat:** [t.me/ForgeMinerChat](https://t.me/ForgeMinerChat)
- **Discord:** [discord.gg/CyU6ASQWSy](https://discord.gg/CyU6ASQWSy)
- **CMP hardware unlock guide:** [wiki · CMP-unlock](https://github.com/0xHashRaptor/ForgeMiner/wiki/CMP-unlock)

---

ForgeMiner

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README