qubic.li - HiveOs Miner

This is the integration of the main client from qubic.li into HiveOS.

Qubminer

Qubic HiveOs Miner
🔧 Hive Os Settings

📚 Qubic Resources

:warning: HiveOs Mandatory Installation Instructions

The CPU running the Client must support AVX2 or AVX512 instructions.
```
cat /proc/cpuinfo | grep avx2
```
(If avx2 appears in the results, use the AVX2 configuration.)
16GB or more RAM is recommended to enhance CPU performance.
Higher RAM frequencies contribute to better CPU performance.
Avoid overloading your CPU with threads; instead, aim to find the optimal balance.
To run the Qubic miner, you need the latest stable version of HiveOS.
```
hive-replace --stable --yes
```

⚙️ NVIDIA GPU Requirements:

[!NOTE] To update your NVIDIA GPU driver on HiveOS, please run the following command:
nvidia-driver-update
NVIDIA 3000 Series: Driver version 535+ or newer.

NVIDIA 4000 Series: Driver version 550+.

✈️ Flight Sheet Configuration

Miner name: Automatically filled with the installation URL.
Installation URL: https://github.com/qubic-li/hiveos/releases/download/latest/qubminer-latest.tar.gz
Hash algorithm: Not used, leave as ----.
Wallet and worker template: Enter your worker name.
Pool URL: Use https://mine.qubic.li/ for the pool app.qubic.li.
Pass: Not used.

[!NOTE] Remove the nvtool line if you prefer to use the HiveOS dashboard for overclocking.

🔨 GPU+CPU (Dual) mining:

Flight Sheet Dual
Extra Config Arguments Example for AVX512:

nvtool --setcoreoffset 200 --setclocks 1600 --setmem 7000 --setmemoffset 2000
"trainer":{"cpu":true,"cpuVersion":"AVX512"}
"amountOfThreads":24
"accessToken":"YOUROWNTOKEN"
AutoUpdate

Extra Config Arguments Example for AVX2:

nvtool --setcoreoffset 200 --setclocks 1600 --setmem 7000 --setmemoffset 2000
"trainer":{"cpu":true,"cpuVersion":"AVX2"}
"amountOfThreads":24
"accessToken":"YOUROWNTOKEN"
AutoUpdate

🔨 GPU mining:

Flight Sheet GPU
Extra Config Arguments Example:

nvtool --setcoreoffset 200 --setclocks 1600 --setmem 7000 --setmemoffset 2000
"accessToken":"YOUROWNTOKEN"
AutoUpdate

🔨 CPU mining:

Flight Sheet CPU
Extra Config Arguments Example for AVX512:

"cpuOnly":true
"trainer":{"cpu":true,"cpuVersion":"AVX512"}
"amountOfThreads":24
"accessToken":"YOUROWNTOKEN"
AutoUpdate

Extra Config Arguments Example for AVX2:

"cpuOnly":true
"trainer":{"cpu":true,"cpuVersion":"AVX2"}
"amountOfThreads":24
"accessToken":"YOUROWNTOKEN"
AutoUpdate

🔧 Hive Os Settings

[!NOTE] The startup script pulls values from the flight sheet to configure the default settings (appsettings_global.json). Each time the miner starts, the appsettings.json file is recreated.

Miner Configuration

Wallet and worker template: Value of "alias" in appsettings.json.
Pool URL: Value of "baseUrl" in appsettings.json.
Extra config arguments: Each line is merged into appsettings.json.

Recommended GPU Overclocks:

Medium:
3000 series nvtool --setcoreoffset 250 --setclocks 1500 --setmem 5001
4000 series nvtool --setcoreoffset 250 --setclocks 2400 --setmem 5001
High:
3000 series nvtool --setcoreoffset 200 --setclocks 1600 --setmem 7000 --setmemoffset 2000
4000 series nvtool --setcoreoffset 200 --setclocks 2700 --setmem 7000 --setmemoffset 2000

⚙️ Extra Config Arguments Box (Options):

[!IMPORTANT] The "isPps" and "useLiveConnection" features currently only works with beta access.

Setting	Default Value	Description
`"accessToken":`	JWT Token	This is your personal Token, which you can obtain from the Control Panel at qubic.li.
`"amountOfThreads":` \| `1`	How many threads should be used for the AI Training.
`"payoutId":` \| `null`	This is the ID you want to get token payout for your found solutions.
`"isPps":` \| `false` \| Set this to `true` to enable `PPS` (Pay Per Share) mode. When enabled, you'll receive a fixed reward for each valid share you submit, regardless of whether a solution is found.
`"useLiveConnection":` \| `true` or `talse` \| Set this to `true` to enhance backend performance, enabling instant ID switching and idling. Note: This requires a constant internet connection.
`"hugePages":nnnn`		Consider enabling huge pages to potentially increase iterations per second. The trainer will suggest the optimal setting based on threads * 138 (e.g., 16 threads = 2208). If the trainer becomes unstable, disable huge pages.
`"trainer":{"cpuVersion":"AVX512"}`		Set this to AVX512 to enforce the use of AVX512 instructions.
`"trainer":{"cpuVersion":"AVX2"}`		Use this setting to force the AVX2 runner on CPUs that do not support AVX512.
`"trainer":{"cpuVersion":"GENERIC"}`		If neither AVX2 or AVX512 CPU instructions are supported, use the GENERIC runner.
`"idleSettings"`		Set the command to target the program you want to run, and set the argument for the specific action the program needs to perform.
`AutoUpdate`		Enable automatic version check and installation for the miner after startup.

🧪 Advanced Settings:

Idle Time Feature

[!NOTE] Starting September 4th, Qubic will introduce idle time every 677 ticks after 676 ticks of mining. During this idle period, you can configure your miner to run any application. The client will handle opening and closing the app. Below is a simple example for any program and miner.

Extra Config Arguments Example for CPU:

"idleSettings":{"command":"ping","arguments":"google.com"}

Extra Config Arguments Example for GPU:

"idleSettings":{"gpuOnly":true,"command":"ping","arguments":"google.com"}

qubic-li / hiveos

readme