Ubuntu Manual Installation

​

Introduction

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 Ubuntu, an enterprise and open source Linux distribution.

​

Requirements

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

​

Environment Setup

​

Ubuntu

To run the quai-gpu-miner, you’ll first need to install and configure Ubuntu v20.04. The quai-gpu-miner is not compatible for compilation with Ubuntu v22 or higher. Instructions on how to download and install Ubuntu on your machine can be found on the Ubuntu installation instructions.

Compatible Version Download: Ubuntu v20.04.

​

Dependencies

Prior to installing any dependencies, you’ll first want to make sure the system is up to date. We can do this by running:

sudo apt update && sudo apt upgrade -y

• CUDA Dependencies
• OpenCL Dependencies

After Ubuntu has updated, we can begin installing the following dependencies:

• git
• cmake
• build-essential
• mesa-common-dev
• nvidia-driver-535
• Nvidia CUDA Toolkit v12.1

Install dependencies using the following command:

sudo apt install -y git cmake build-essential mesa-common-dev nvidia-driver-535

Install CUDA with the following commands:

wget https://developer.download.nvidia.com/compute/cuda/12.1.0/local_installers/cuda_12.1.0_530.30.02_linux.run

sudo sh cuda_12.1.0_530.30.02_linux.run

The above command will open a flow where you are able to select which components of the CUDA Toolkit you’d like to install. Ensure your selections are IDENTICAL to the image below.

Unselect “Driver”, and only select “CUDA Toolkit 12.1”.

After completing this step, you may see a warning saying that the CUDA compatible drivers were not installed — as long as you previously installed nvidia-driver-535, you can safely ignore this warning.

After installing dependencies, reboot your machine to ensure all updates are applied correctly.

sudo reboot

​

Build and Run

Now that the environment and dependencies are fully configured, we can start installing quai-gpu-miner.

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-miner and navigate to the quai-gpu-miner directory:

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.

​

Build

Start by making a directory named build and navigating to it:

mkdir build && cd build

Once inside of the build directory, we’ll need to install all of the build dependencies using cmake and then build and compile the miner shown below.

• CUDA
• OpenCL

cmake .. -DETHASHCUDA=ON && cmake --build .

​

Run

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.

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

Once you have the address and port and are in the build directory, run the following command to start the miner:

./ethcoreminer/ethcoreminer -G -P stratum://PROXYIPADDRESS:STRATUMPORT

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

​

Stop

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.