Introduction

Here, we’ll be installing quai-gpu-miner, the implementation of a Quai Network ProgPOW miner. This tutorial focuses on installing and running quai-gpu-miner on HiveOS, a Linux based operating system that makes GPU mining easy. HiveOS also provides a web based dashboard for streamlined management and maintenance of your Quai Network GPU miner.

Be sure to keep the private keys of the accounts you mine into. Signing a message from the accounts you mine into will be required to claim Mainnet rewards.

Requirements

In order to run the quai-gpu-miner on HiveOS and mine valid blocks, you’ll need the following:

Synced go-quai node

Configured Stratum proxy

HiveOS machine

AMD or NVIDIA GPU

4GB+ of RAM

Environment Setup

HiveOS

For this tutorial, you’ll need a HiveOS machine. Instructions for how to install HiveOS on your rig and configure it can be found on the HiveOS installation documentation.

Drivers and Updates

Once you’ve installed and set up HiveOS on your rig, you’ll need to update drivers, install some GPU utility packages, and ensure Hive is up to date.

Prior to starting updates and installs, we need to switch users. Do this by running:

sudo su user

To upgrade HiveOS, run:

sudo selfupgrade

To update and install necessary graphics card drivers, run:

sudo nvidia-driver-update

Installation

Now that all of our dependencies are installed, we can install quai-gpu-miner. There are two options for installation:

Installing the GPU miner via pre-compiled binaries is recommended for vast majority of users. It is the simplest and fastest way to get started mining.

The latest release of quai-gpu-miner is available for download from the GPU miner releases page.

To download the binaries for the latest release into the output directory, run the following command:

sudo wget -P output https://github.com/dominant-strategies/quai-gpu-miner/releases/latest/download/quai-gpu-miner-nvidia

This will create an output directory with two built binaries in it: quai-gpu-miner-amd and quai-gpu-miner-nvidia. For the card type you have, run the following command to make the binary executable:

chmod +x output/quai-gpu-miner-nvidia

Configure and Run

Run

To run the miner, you’ll need a Stratum proxy to connect to. Visit the quai-stratum-proxy docs for information on how to install and configure it. The proxy configuration will determine which shard your gpu-miner is running on and the address payouts are awarded to.

First, you’ll need to obtain the IP Address and port your proxy is running on from the Stratum proxy logs. The default port is 3333.

If your miner and proxy are on the same machine, the PROXYIPADDRESS will be localhost. If your miner and proxy are not on the same machine, you may need to port forward the proxy port.

Once you’ve obtained the IP Address and port, run the miner with the following command, making sure to replace PROXYIPADDRESS with the IP Address and STRATUMPORT with the port your proxy is running on:

./output/quai-gpu-miner-nvidia -U -P stratum://PROXYIPADDRESS:STRATUMPORT

The quai-gpu-miner should now be running and outputting logs to the terminal.

Do not start the miner before confirming your node has fully synced. Mining while your node is not synced will result in the mining of invalid blocks and wasted hash.

Stop

To stop the miner, simply use CTRL+C to kill the terminal process. Once logs are no longer being outputted to the terminal, the miner has stopped.