Introduction
Here, we’ll be running an instance of quai-gpu-miner, the implementation of a Quai Network ProgPOW miner, via Docker. Docker is a platform for creating, managing, and running containers. Containers are beneficial because they can package all the dependencies needed to run an application.Requirements
In order to run the quai-gpu-miner with Docker and mine valid blocks, you’ll need the following:Environment Setup
You’ll need to have docker installed. You can learn more about how to do that on Docker’s installation instructions.Creating the miner binary
This section will explain how to build the miner binary yourself using Docker. You can skip to the next section if you are only interested in running with our provided binary.You may need to run the command with
sudo
depending on how docker is configured on your system.output
folder:
- A binary and hive package for Nvidia GPUs.
- A binary and hive package for AMD GPUs.
Running the miner
You will need to run the following steps in order to give Docker access to your GPU.sudo apt install ubuntu-drivers-common && ubuntu-drivers autoinstall
sudo reboot
curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg && \ curl -s -L https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list | \ sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | \ sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list && \ sudo apt-get update && sudo apt-get install -y nvidia-container-toolkit
sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker
You may need to run the command with
sudo
depending on how docker is configured on your system.This command also modifies the logging behavior of docker so that prints to stdout/stderr don’t use an unlimited amount of storage on the host machine.