Simple yet powerful monitoring agent.
- Introduction
- Hive OS Client and Hiveon ASIC Firmware comparison
- Supported models
- Prepare
- Install
- Other models
- Recovery boot images
- Useful commands
Hive OS Client and Hiveon ASIC Firmware are two different products:
- Allows you to see the miner in Hive, to control Wallets, Pools, restart and reboot the miner.
- Supports a broad range of ASIC models: Antminer, Innosilicon, Zig and even some FPGA miners.
It's a lightweight application running on the stock (or custom fw of your choice) ASIC firmware.
Hiveon ASIC Firmware (follow the link)
All the features above plus:
- Overclocking, undervolting the miner, thus offering increased performance and/or lower consumption and heat.
- More control of overclocking and adjustment to voltage.
- Auto-tune to optimize overclocking almost automagically.
It's a custom firmware that does replace the stock one. Supports only selected models: Antminer S17, S17 Pro, S9, S9i, S9j and T9+. Hiveon Firmware for other ASIC models like S9k/S9SE/T17 are coming soon, so stay tuned!
Find out more: Download, FAQ, Step-by-step installation manual for S17/S17 Pro
Model / Feature | See miner in Hive OS | Control wallets & pools | Restart miner | Reboot miner | Anti-virus (Hiveon FW only) | Over clocking (Hiveon FW only) | Under volting (Hiveon FW only) | Voltage adjustment (Hiveon FW only) | Auto-tuning (Hiveon FW only) |
---|---|---|---|---|---|---|---|---|---|
Antminer | |||||||||
A3 | • | • | • | • | |||||
B3 | • | • | • | • | |||||
D3, D3 (Blissz) | • | • | • | • | |||||
DR3 | • | • | • | • | |||||
E3 | • | • | • | • | |||||
L3+, L3++ | • | • | • | • | |||||
S7 | • | • | • | • | |||||
S9, S9i, S9j | • | • | • | • | • | • | • | • | • |
S9k, S9SE, S9-Hydro | • | • | • | • | soon | soon | soon | soon | soon |
S10 (mskminer) | • | • | • | • | |||||
S11 | • | • | • | • | |||||
S15 | • | • | • | • | |||||
S17, S17 Pro | • | • | • | • | • | • | • | • | • |
S17+ | • | • | • | • | soon | soon | soon | soon | soon |
T9 | • | • | • | • | |||||
T9+ | • | • | • | • | • | • | • | • | • |
T15 | • | • | • | • | |||||
T17 | • | • | • | • | beta | beta | beta | beta | beta |
T17+ | • | • | • | • | soon | soon | soon | soon | soon |
X3 | • | • | • | • | |||||
Z9, Z9-Mini | • | • | • | • | |||||
Z11 | • | • | • | • | |||||
Innosilicon | |||||||||
A5/A8 (need test) | • | • | • | • | |||||
A9 ZMaster | • | • | • | • | |||||
D9 DecredMaster | • | • | • | • | |||||
S11 SiaMaster | • | • | • | • | |||||
T3 BTCMiner | • | • | • | • | |||||
T3H+, T3+, T2Th+, T2Thf+, T2Thl+, T2Th, T2Tz-30T, T2Thm, T2Thf, T2T+ (32T), T2Ts-26T, T2Ti-25T, T2T-24T | • | • | • | • | |||||
Todek | |||||||||
Toddminer C1, C1 PRO | • | • | • | • | |||||
HashAltCoin | |||||||||
Blackminer F1, F1+, F1-MINI | • | • | • | • | |||||
Blackminer F1-Ultra, F1-MINI+ | • | • | • | • | |||||
Zig | |||||||||
Z1, Z1+ | • | • | • | • |
- Antminer
- A3
- B3
- D3, D3 (Blissz)
- DR3
- E3
- L3+, L3++
- S7
- S9, S9i, S9j, S9k, S9SE, S9-Hydro, S9 (VNISH), S9 (mskminer), S11
- S10 (mskminer)
- S15, T15
- S17, S17 Pro, T17 (deprecated in favor of Hiveon firmware)
- T9, T9+
- X3
- Z9, Z9-Mini
- Z11
- Innosilicon
- A5/A8 (need test)
- A9 ZMaster
- D9 DecredMaster
- S11 SiaMaster
- T3 BTCMiner
- T3H+, T3+, T2Th+, T2Thf+, T2Thl+, T2Th, T2Tz-30T, T2Thm, T2Thf, T2T+ (32T), T2Ts-26T, T2Ti-25T, T2T-24T
- Todek
- Toddminer C1, C1 PRO
- HashAltCoin
- Blackminer F1, Blackminer F1+, Blackminer F1-MINI
- Blackminer F1-Ultra, Blackminer F1-MINI+
- Zig
- Z1, Z1+
- Antminer Series 9 (S9/S9i/S9j/T9/T9+): never upgrade to firmware newer than 10-Jun-2019
- Antminer Series 17: never upgrade to firmware newer than 01-Dec-2019
All newer versions of official firmware have defensive countermeasures against remote tampering, so you won't be able to install Hive OS Client or Hiveon ASIC Firmware.
To link ASIC to your Hive Farm you could use these options, sorted by ease:
- Hive OS tab in the ASIC web interface (simpliest!)
firstrun
command viassh
- Download a special .tar.gz file via BTC Tools (mass deployment)
In all cases, you'll need the FARM_HASH string. You will find it in Hive OS dashboard, right in the farm's Settings tab.
To start mining, be sure to create a Flight Sheet first. Apply it to start hashing.
You can install Hive OS Client via firmware file download or via SSH.
These models are special. They're loading OS right to the RAM in read-only mode. Hive OS Client installation is possible only by upgrading ASIC with a special firmware file. That file contains stock Bitmain firmware with built-in Hive OS client:
After successful flashing, you have to open up ASIC web interface, click Hive OS tab, enter your FARM_HASH and then click Apply&Save button. The page will refresh itself. Wait a minute and worker will appear in the Hive dashboard.
Hive OS Client for Antminer Series 3/7/9, firmware date before 10.06.2019. Just upgrade ASIC firmware with hive_install_unsig_antminers.tar.gz.
All things you do with an ASIC web interface you could do better with BTC Tools utility. It's the best choice in case you have ASICs in numbers. Scan your network, select ASICs to update and then click "Firmware Upgrade".
Login with SSH to your miner and run the following command:
cd /tmp && curl -L --insecure -s -O https://raw.githubusercontent.com/minershive/hiveos-asic/master/hive/bin/selfupgrade && sh selfupgrade
For Antminer D3 Blissz, before installation run:
ln -s /usr/lib/libcurl-gnutls.so.4 /usr/lib/libcurl.so.5
Force setup FARM_HASH or RIG_ID and password, change API Server URL:
firstrun
or firstrun YOUR_FARM_HASH
- set when there is no config
firstrun -f
or firstrun YOUR_FARM_HASH -f
- force set to replace the config
- Antminer: user root, password admin
- Innosilicon (ssh/telnet): user root, password blacksheepwall (or innot1t2, or t1t2t3a5)
You could add ASIC without entering RIG_ID, password and API Server URL.
Get your FARM_HASH from Hive OS dashboard. Replace your_farm_hash
string you see below with your FARM_HASH. Transform the text below and then run as a single command:
cd /tmp && curl -L --insecure -s -O https://raw.githubusercontent.com/minershive/hiveos-asic/master/hive/bin/selfupgrade && FARM_HASH='your_farm_hash' sh selfupgrade
Replace http://your_api_server
string you see below with your API Server URL. Transform the text below and then run as a single command:
cd /tmp && curl -L --insecure -s -O https://raw.githubusercontent.com/minershive/hiveos-asic/master/hive/bin/selfupgrade && HIVE_HOST_URL='http://your_api_server' sh selfupgrade
Replace your_farm_hash
string you see below with your FARM_HASH. Replace http://your_api_server
string you see below with your API Server URL. Transform the text below and then run as a single command:
cd /tmp && curl -L --insecure -s -O https://raw.githubusercontent.com/minershive/hiveos-asic/master/hive/bin/selfupgrade && FARM_HASH='your_farm_hash' HIVE_HOST_URL='http://your_api_server' sh selfupgrade
You can install Hive OS Client on all the ASICs you have on your local network. For this you need to have a running Linux box (like Hive OS GPU rig) or Antminer ASIC with Hive OS Client. You could do it with just three commands.
- Skip this step if you're on the ASIC with Hive OS Client. Install sshpass and curl:
apt-get install -y sshpass curl
- Download script:
cd /tmp && curl -L --insecure -s -O https://raw.githubusercontent.com/minershive/hiveos-asic/master/hive/hive-asic-net-installer/download.sh && sh download.sh
- Execute it:
cd /tmp/hive-bulk-install
Edit config.txt
to set your FARM_HASH or firmware URL, edit ips.txt
to set IPs list of your new ASICs.
Or you can scan the local network to search for Antminer. Example: ipscan.sh 192.168.0.1/24 > ips.txt
To install Hive OS Client just run install.sh
.
To install firmware on Antminer S9/i/j just run firmware.sh
.
- Optionally, you can add WORKER_NAME to
ips.txt
(e.g.192.168.1.100 asic_01
)- When IP was being processed then it will become #commented
If you want to install specific version or downgrade to specific version, please append version as an argument to selfupgrade
. E.g. 0.1-02:
cd /tmp && curl -L --insecure -s -O https://raw.githubusercontent.com/minershive/hiveos-asic/master/hive/bin/selfupgrade && sh selfupgrade 0.1-02
Locally on ASIC you can run selfupgrade
command.
To install specific version you should run selfupgrade 0.1-02
.
If you want to reinstall version please add --force
to the command like this selfupgrade 0.1-02 --force
.
To install stable development version from repository please run selfupgrade master
.
To install night build development version directly from Github please run selfupgrade master github
.
hive-uninstall
A cron
jobs might have to be removed manually with crontab -e
even if they are left there the would do nothing.
Hiveon ASIC installation - Antminer S9 Cannot Find Signature Fix
Hiveon ASIC Firmware 1.02 for S9 Installation Manual
You don't need to unlock SSH or do anything complicated. For any ASIC with mskminer custom firmware, you have to download Hive OS Client Installer for mskminer firmware and then flash the ASIC with it. That's all.
Hive OS Client Installation Manual for S17/T17
Hive OS Client Installation Manual for Innosilicon
Note: some Innosilicon factory firmware have a memory leak, and ASIC freezes every few days. To solve this problem, you can enable the miner or ASIC reboot for every 24 hours. Run the following commands:
inno-reboot miner enable/disable
inno-reboot asic enable/disable
inno-reboot status
sudo su -
cd /tmp && wget https://raw.githubusercontent.com/minershive/hiveos-asic/master/hive/bin/selfupgrade && bash selfupgrade
or
sudo su -
cd /tmp && wget https://raw.githubusercontent.com/minershive/hiveos-asic/master/hive/bin/selfupgrade && FARM_HASH=replace_with_your_farm_hash bash selfupgrade
Hive OS Client Installation Manual for Zig Z1+
cd /tmp && wget https://raw.githubusercontent.com/minershive/hiveos-asic/master/hive/bin/selfupgrade && bash selfupgrade
or
cd /tmp && wget https://raw.githubusercontent.com/minershive/hiveos-asic/master/hive/bin/selfupgrade && FARM_HASH=replace_with_your_farm_hash bash selfupgrade
You can find recovery boot images at our repository (highly recommended) or Bitmain's official site.
Please note the two different file formats of recovery images:
.img
file. It's a raw disk image. Should be written to SD with a special imaging software..zip
file. A ZIP archive containing files likeu-boot.img
anduImage.bin
inside. Unzip that file to SD card formatted with FAT32.
- S9 Recovery image
- S17 Hiveon recovery image (beta)
- S17, S17 Pro, T17
- Download recovery boot image
- Use SD card size less than 16 Gb
- Format SD card with FAT32
- Unzip it to SD card
- Boot ASIC with SD card
- ASIC booted in recovery mode
- Flash any suitable old stock Bitmain firmware (
.tar.gz
format) via web interface.
In case of issues, please read Bitmain's control board program recovery manual.
To search for an Antminer ASIC among a large number of ASICs, you can make it flash a red LED on its front panel. To do this, execute the command from the Hive OS dashboard or via SSH:
asic-find 5
The red LED will be blinking for 5 minutes.
To rename the workers in the Hive web interface as the hostname, run the command from the Hive OS dashboard:
hello hostname