Comment on page
HiveOS Manual OpenCL Installation
Here, we'll be installing quai-gpu-miner, the main implementation of a Quai Network GPU 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.
If you are mining for Testnet Rewards, be sure to KEEP THE PRIVATE KEYS OF THE ACCOUNTS YOU MINE INTO. Signing transactions from the accounts you mine into (using their private keys) will be the only acceptable way to prove how many blocks you mined in the Iron Age Testnet when it is time to claim Mainnet rewards.
In order to run the quai-gpu-miner on HiveOS and mine valid blocks, you'll need the following:
Once you've installed and set up HiveOS, you can either proceed with the installation manually by following this documentation, or build and install the miner via a script. Either method of setting up a GPU mining rig will get you to the same point.
The recommended method of installing and building the miner in HiveOS is with the provided script. The manual installation is only recommended for users needing more customization regarding drivers/packages.
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:
To update and install necessary graphics card drivers, run:
Once drivers have been installed and updated, we'll need to install OpenCL:
sudo amd-ocl-install 22.20
Prior to installing any dependencies, you'll first want to make sure our system is up to date. We can do this by running:
sudo apt update && sudo apt upgrade -y
After Ubuntu has updated, we can begin installing the following dependencies:
Install all dependencies using the following command:
sudo apt install -y git cmake build-essential mesa-common-dev
Finally, after installing all necessary dependencies and drivers, reboot your machine to ensure all updates are applied correctly using:
Now that the environment and dependencies are fully configured, we can start installing
First, make sure you're in the home directory for the correct user. You can do this by running:
sudo su user -
Now, clone the
quai-gpu-minerand navigate to the
git clone https://github.com/dominant-strategies/quai-gpu-miner && cd quai-gpu-miner
To install and update external repository dependencies, run the following:
git submodule update --init --recursive
This will ensure that all the submodules referenced in the repository are properly initialized and up to date.
Start by making a directory named
buildand navigating to it:
mkdir build && cd build
Inside of the build directory, we'll need to install all of the build dependencies using
cmakeand then build and compile the miner.
cmake .. && cmake --build .
Running this command may take a while to complete.
To run the miner, you'll need a quai-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.
Once you have the address and port and are in the
builddirectory, run the following command to start the miner:
PROXYIPADDRESSwith the IP address of your proxy. Replace
STRATUMPORTwith the websocket port of your proxy, which is default set to
./ethcoreminer/ethcoreminer -G -P stratum://PROXYIPADRESS:STRATUMPORT
To stop the miner, simple use CTRL+C to kill the terminal process. Once logs are no longer being outputted to the terminal, the miner has stopped.