​
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:

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

This will create a built quai-gpu-miner file in the output directory. Make quai-gpu-miner executable by running:

sudo chmod +x output/quai-gpu-miner

​
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.

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 -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.

In the future, a HiveOS Flight Sheet will be released for smoother management of your Quai Network miner on HiveOS.

Was this page helpful?

Run A Local NetworkHiveOS Flight Sheet Installation