How Do You Install Mining Software on HiveOS?

Prerequisites for HiveOS Mining Setup

1. A compatible GPU or ASIC device must be physically installed and recognized by the motherboard BIOS/UEFI before booting HiveOS.

2. The HiveOS image must be written to a USB drive using BalenaEtcher or Rufus with verified SHA256 checksum matching the official release.

3. Network connectivity—either via Ethernet cable or configured Wi-Fi—is mandatory during first boot to fetch miner configurations and system updates.

4. An active Hiveon account with wallet address registered in the dashboard is required to assign rigs and push configuration profiles.

5. BIOS settings must disable Secure Boot, Fast Boot, and CSM/Legacy mode; enable Above 4G Decoding and Resizable BAR if supported.

Initial Boot and Rig Registration Process

1. Insert the prepared USB drive and power on the rig; press F12 or ESC to select boot device depending on motherboard vendor.

2. HiveOS boots into minimal CLI interface; after ~90 seconds, the system displays a unique rig ID and QR code on screen.

3. Navigate to hiveos.farm and log into your account; click “Add Rig” then scan the QR code or manually enter the rig ID.

4. Assign the rig to a group, label it meaningfully (e.g., “RTX4090-ETH-LHR”), and confirm hardware detection status in the dashboard.

5. The system automatically downloads core OS modules, including watchdog, fan control daemon, and monitoring agents within five minutes.

Miner Installation via Web Dashboard

1. From the rig’s detail page, click “Miners” tab and select a pre-validated binary—such as T-Rex v0.26.11, GMiner v5.45, or LolMiner v1.62—for your specific GPU architecture.

2. Click “Install” next to the chosen miner; HiveOS downloads the archive, validates its signature, extracts binaries, and sets execution permissions.

3. Configure pool settings directly in the web UI: enter pool URL (e.g., stratum+tcp://eth-eu.flexpool.io:5555), wallet address, worker name, and password fields.

4. Enable auto-start, temperature limits, and overclocking presets through the “Tuning” section without editing config files manually.

5. Save changes and trigger “Restart Miner” from the action menu—the miner launches within 8–12 seconds and begins submitting shares immediately.

Local CLI-Based Miner Deployment

1. SSH into the rig using default credentials (hive / hive) and run sudo su to gain root access.

2. Use miner install command followed by miner name and version, e.g., miner install trex 0.26.11.

3. Manually place custom config JSON in /hive/miners/t-rex/conf.json, ensuring correct stratum endpoint, wallet, and algorithm parameters.

4. Validate syntax with jq . /hive/miners/t-rex/conf.json before initiating service restart.

5. Start the miner process with miner start trex; verify operation via miner status and real-time hash rate output.

Frequently Asked Questions

Q: Can I install multiple miners simultaneously on one HiveOS rig?A: Yes. HiveOS supports concurrent miner instances provided they target different algorithms or pools. Each miner runs under isolated systemd units with independent logging and resource constraints.

Q: What happens if a miner binary fails signature verification during installation?A: HiveOS blocks the installation and logs the failure in /var/log/hive/miner-install.log. Only miners signed by Hiveon or listed in the official whitelist are permitted.

Q: Is it possible to roll back to a previous miner version after an update?A: Yes. The “Miners” tab includes a version history dropdown; selecting any prior stable release triggers automatic reinstallation and config preservation.

Q: Does HiveOS support custom-built miner forks compiled from source?A: Not natively. Manual deployment requires disabling the hive-miner service, placing binaries in /hive/miners/custom/, and defining a custom systemd unit with proper sandboxing and watchdog integration.