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
  • XMR 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

• 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 wss://wps.qubic.li/ws for the pool https://pool.qubic.li/.
• Pass: Not used.

🔨 GPU+CPU (Dual) mining:

Note

"amountOfThreads":0 will use all available threads minus one.

Extra Config Arguments Example:

"amountOfThreads":0
"accessToken":"YOUROWNTOKEN"
AutoUpdate

🔨 GPU mining:

Extra Config Arguments Example:

"accessToken":"YOUROWNTOKEN"
AutoUpdate

🔨 CPU mining:

Extra Config Arguments Example:

"cpuOnly":true
"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 "poolAddress" in appsettings.json.
• Extra config arguments: Each line is merged into appsettings.json.

⚙️ XMR Configuration

Setting	Default Value	Description
"xmrMining"	true	Enable or disable XMR mining
"xmrGpu":	false	Enable or disable GPU mining
"xmrPool":	xmr.qubic.li:3333	Use this to connect your XMR miner to an alternative stratum server pool address
"xmrCustom":	null	A string of parameters passed to XMRig (e.g., -t 1 to run an XMR instance with only one thread). Command Line Options
"stratumBridge":	true	Enable or disable Stratum bridge
"stratumBridgeAddress":	wss://stratum.qubic.li/stratum	Use this to connect your custom Stratum bridge

⚙️ Recommended GPU Overclocks:

3000 series nvtool --setcoreoffset 150 --setclocks 1500 --setmem 5001 --setmemoffset 2000
4000 series nvtool --setcoreoffset 150 --setclocks 2400 --setmem 7001 --setmemoffset 2000

⚙️ Extra Config Arguments Box (Options):

Setting	Default Value	Description
"accessToken":	JWT Token	This is your personal Token, which you can obtain from the Control Panel at qubic.li.
"qubicAddress":	null	This is the ID you want to get token payout for your found solutions.
pps:	true	Set this to false to disable 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.
"amountOfThreads":0	All available -1	How many threads should be used for the AI Training.
"trainer":{"cpu":true,"cpuVersion":"AVX512"}		Set this to AVX512 to enforce the use of AVX512 instructions.
"trainer":{"cpu":true,"cpuVersion":"AVX2"}		Use this setting to force the AVX2 runner on CPUs that do not support AVX512.
"trainer":{"cpu":true,"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

During the Qubic idling phase, you can run another program or miner.

Extra Config Arguments Example:

"idleSettings":{"preCommand":"ping","preCommandArguments":"-c 2 google.com","command":"ping","arguments":"google.com","postCommand":"ping","postCommandArguments":"-c 2 google.com"}

Setting	Description
command	The command/program to execute.
arguments	The arguments that should be passed to the command/program.
preCommand	A command/program to start once the idling period begins.
preCommandArguments	The arguments that should be passed to the preCommand/program.
postCommand	A command/program to start once the idling period stops.
postCommandArguments	The arguments that should be passed to the postCommand/program.