HiveOS Installation
Install and run a Quai Network GPU miner on HiveOS.
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:
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:
To upgrade HiveOS, run:
To update and install necessary graphics card drivers, run:
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:
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:
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:
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.
Was this page helpful?