qubic.li - HiveOs Miner

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

• Qubic HiveOs Miner
  • Qubic Resources
  • HiveOs Mandatory Installation Instructions
  • ✈️ Flight Sheet Configuration:
    • GPU+CPU (Dual) mining
    • GPU mining
    • CPU mining
• 🔧 Hive Os Settings
  • Miner Configuration
  • Recommended GPU Overclocks
  • Extra Config Arguments Box (Options)
  • Advanced Settings

📚 Qubic Resources

• Official Qubic.li Client
• Qubic Website
• Qubic Web Wallet
• Qubic Mining Pool

⚠️ 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:

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:

Extra Config Arguments Example:

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

🔨 CPU mining:

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"}