> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parallaxprotocol.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Mining with your GPU

> How to mine Parallax with your GPU using Hashwarp, the official XHash miner.

[Hashwarp](https://github.com/ParallaxProtocol/hashwarp) is the official GPU miner for Parallax's [XHash](/protocol/foundational-topics/consensus/algorithms/xhash) Proof-of-Work. It mines on **NVIDIA** GPUs (CUDA) and **AMD** and other GPUs (OpenCL), on a mining pool or solo on your own node. It has no dev fee.

Besides mining, Hashwarp:

* Sets itself up: run it without options and a short wizard asks how you want to mine.
* Protects your hardware: temperature limits per GPU, a shutdown temperature, and a watchdog that restarts a GPU when it fails. Every solution is checked before it is submitted.
* Tunes your GPUs: memory and core clocks, power limits and fans per GPU, and `--oc-tune`, which finds the best settings for each one.
* Shows what it does: a web dashboard of one rig or all of them, a JSON API and Prometheus metrics.
* Warns you when your pool finds most of the network's blocks, which puts the network at risk.
* Runs on HiveOS and mmpOS with ready-made packages.

***

## Prerequisites

* An **NVIDIA** GPU (driver 525 or newer) or an **AMD** GPU (AMD driver with OpenCL: Adrenalin on Windows, ROCm on Linux), with enough memory for the XHash DAG: about 1.7 GB in late 2026, growing slowly with each epoch.
* **Windows** 10 or newer, or **Linux** with glibc 2.28 or newer (Ubuntu 20.04, Debian 10, RHEL 8 and later). Everything else Hashwarp needs comes in the download.
* A Parallax address to receive rewards, or your own [Parallax client](/guides/client/setup) to mine solo.

***

## Step-by-step Guide

<Steps>
  <Step title="Download Hashwarp">
    Download the archive for your operating system from the [Hashwarp releases](https://github.com/ParallaxProtocol/hashwarp/releases) and extract it. It holds the `hashwarp` executable, a sample configuration (`hashwarp.json.example`) and start scripts.

    On HiveOS or mmpOS, use the ready-made package instead: see [HiveOS & mmpOS](/hashwarp/rig-os).
  </Step>

  <Step title="Start it">
    Run `hashwarp` without options. The first time, it asks whether you want to mine on a pool or solo, which pool, your address and a name for the rig, saves the answers in `hashwarp.json` and starts mining. Next time it starts with that configuration.

    Or give the options on the command line. On a pool:

    ```bash theme={null}
    hashwarp --pool <POOL_HOST>:<PORT> --wallet <YOUR_ADDRESS> --worker rig1
    ```

    Replace `<POOL_HOST>:<PORT>` with the pool's address and `<YOUR_ADDRESS>` with your Parallax address. The worker name tells your rigs apart on the pool's dashboard. See [Mining on a Pool](/hashwarp/pool-mining) to choose a pool, or [Solo Mining](/hashwarp/solo-mining) to mine on your own node.
  </Step>

  <Step title="Check that it mines">
    Hashwarp prints the hashrate every 10 seconds and a line for each share the pool accepts:

    ```
    05:57:14  INFO  share  ✔ accepted gpu0 · diff 8.59 GH · 364 ms · A20 R1
    05:57:20  INFO  miner  115.42 MH/s · 60s 115.43 · 15m 116.18 · eff 133.62 · A20 R1 · 71°C · fan 53% · 377 W · 306 kH/J
    ```

    The line shows the current hashrate and its 1 and 15 minute averages, the effective hashrate (what the pool credits you), the accepted (`A`) and rejected (`R`) shares, then the temperature, fan, power and efficiency. Press `s` for a table per GPU, or `h` for the other keys. [Output & Logs](/hashwarp/output-and-logs) explains every part.
  </Step>
</Steps>

<Tip>
  Run `hashwarp --selftest` once after installing, and after changing drivers or overclocking: it mines offline for up to 30 seconds, checks every GPU's results on the CPU and says PASS or FAIL for each GPU.
</Tip>

***

## Next steps

<CardGroup cols={2}>
  <Card title="Configuration" icon="sliders" href="/hashwarp/configuration">
    The configuration file, the wizard and how options combine.
  </Card>

  <Card title="Overclocking" icon="gauge-high" href="/hashwarp/overclocking">
    Clocks, power and fans per GPU, and `--oc-tune` to find the best settings.
  </Card>

  <Card title="Dashboard" icon="chart-line" href="/hashwarp/dashboard">
    A web dashboard of this rig, or of all your rigs.
  </Card>

  <Card title="Safety" icon="shield-halved" href="/hashwarp/safety">
    Temperature limits, the watchdog and exit codes.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.