Hive OS is an all-in-one monitoring and management tool for your mining rigs. Whether its a single rig or several thousands, you and your team can easily manage them all from a single dashboard.
In this article we’ll walk you through the first time installation process and explain what different installation types there are, and how to easily set up your rigs and connect them to your account dashboard.
We strongly suggest setting up Two Factor Authentication (2FA) for additional account security. You can find these settings by clicking on your user name in the top right corner and then going to the Account tab. Scroll down to the Two-factor Authentication option and switch 2FA on. Then follow the onscreen instructions carefully.
As soon as you’re done with setting up your account, it’s time to connect your rigs to the dashboard. GPU rigs and ASICs are uniformly referred to as workers. You will have two options of connecting your workers, via Farm Hash or via manual setup. Farm Hash is used for connecting your workers to a Farm without pre-creating the rig in the dashboard. This is our new and fast method of connecting a worker to a Farm, so we recommend this setup method for most users. We will go into more details on Farms and how to use them in our next articles.
Each Farm has its unique Farm Hash. You can find your Farm Hash by going to your Farm’s Settings tab. Once you write the installation image, you may then add your
FARM_HASH to the
rig.conf file which you will find in the root folder of the image. We’ll explain this step in detail below.
Farm Hash can be effectively used with Hive Flasher for bulk rig installations. More details on Hive Flasher are available here.
Users that have previously used Hive OS will be familiar with this option of connecting their worker to the dashboard. It involves using a rig ID and a password for each miner to be configured. Although it’s a bit more tedious than connecting workers via Farm Hash, we left it for our old school users’ convenience.
Click on the plus in the top right corner and choose Add Worker option.
A window, Add New Worker, will pop up with the following fields:
You will now see your rig added to the list of workers, but first you will need your rig ID. After you pre-created your worker, you will be forwarded to the worker’s dashboard. Go to the worker’s Settings tab and you should see the rig ID and the Password.
The ID of the rig and the password will be needed during the initial installation and first boot, in case you opted for this option instead of Farm Hash, so we recommend writing it down.
Hive OS can be installed on both GPU rigs and ASICs as well. Below we will describe the different types of installations:
Go to the download page to get the latest version of Hive OS. You can download the image from our website as a .zip file or via .torrent if you prefer. You will also have the option of downloading Hive OS for ASICs or our Bulk Installation tool.
We recommend installing the OS image to an SSD. SSDs are much more reliable and we advise using them in production environments. Because many users still prefer using a USB flash drive, we have the logs turned off by default. If you installed the OS on an SSD, you can optionally turn logging back on by running the logs-on command after installation.
Here is some more information on flash drives, SSD and HDD: When to use flash drives? Firstly when you want to test. This is easy, you just grab one you have and in a dozen of minutes you can plug it in and test Hive without ruining your current Windows, for instance. Any flash will work, USB 3.0 is not required. It’s just a matter of boot speed. Then if you are happy with it you can leave it as it is.
The downfalls of using flash pen drives. They are slow to write. Even if it’s 3.0 it still may have slow writes speed line 10-15mbps, while reading can be 60-100mbps. So waste time on writing new images if you have a lot of rigs.
They can work like forever or die in few days. Some show you corrupt file system with messages like this:
Some even fail to boot.
But what is great about the flash drives is that they are cheap. You can buy a bucket of them and just throw them out when they fail.
But if your location is distant this is not your choice. Go SSD. SSD is the best option. The only bad thing is the price. Probably you can find some cheap on aftermarket.
HDD. This is the option if you just have it and that’s it. The price for 32gb SSD and 200gb HDD is roughly the same and there is no reason you should choose HDD over SSD.
And the last thing. Buy a SSD USB 3.0 pocket or tray to connect it to your computer.
From version 0.5-30 you can run
logs-off to put log in RAM to save your USB flash drive.
And a few more words about common booting problems. In general you just plug your drive in the rig and it goes. But sometimes it just doesn’t. Firstly you should ensure you are not trying to boot from UEFI partition. Some bioses give you this option to choose and you should not do it.
Your USB settings should have Legacy mode On. Like for mouse and keyboard to work at boot time, otherwise USB drive will not be detected. IOMMU might be an issue on some motherboards. Sometimes it’s called CSM (compatibility support module)
Okay, drive is detected, it starts but fails after like this: This tells you that’s there is some problem with the image written. Usually it’s solved with trying to write the image with alternative software:
You will need to write Hive OS image onto an SSD. Although many users prefer to use USB drives, we recommend opting to an SSD instead. Start by extracting the image from the .zip file first and then writing the .img file onto a drive.
MacOS and Linux users can do it with ease using Etcher, or several other programs.
After the image is flashed you will discover a newly created drive in your system where you will be able to pre-configure your worker with either Farm Hash or it’s ID and password. Find
rig-config-example.txt on HIVE drive and open it with a .txt editor. You can use the integrated text editors on Windows, MacOS and Linux or download a free alternative. For example, Notepad++ for Windows or Sublime Text for MacOS and Linux.
Now choose one of the two options below:
Once the image copy is complete, you can go to your drive in Windows, Linux or Mac and find
rig-config-example.txt file in the root folder. Here’s how it looks:
The contents of rig-config-example.txt file
Enter your Farm Hash in the
FARM_HASH= field by copying the value from your Settings tab. Here’s how the field should look like:
No need to set RIGID or RIGPASSWD in this case. That’s it, just save your config file and rename it into
rig.conf. Proceed by finishing the image installation and boot your worker. It will connect to the dashboard automatically.
Once the image copy is complete, you can go to your drive in Windows, Linux or Mac and find rig-config-example.txt file in the root folder. Here’s how it looks:
The contents of rig-config-example.txt file
Find and fill in the two fields:
That’s it, just save your config file and rename it into rig.conf. Proceed by finishing the image installation and boot your worker. It will connect to the dashboard automatically.
Before proceeding with installation, make sure that your ASIC miner is supported. The current list of supported models:
Actual list can be always found on GitHub.
Remotely connect to your worker using SSH. You can do it with Teleconsole. Teleconsole is an SSH tunnel to your rig. In few words you start it on the rig and open SSH in browser or in Linux/Mac console. Does not require any VPN or being in local network. To start it run
telec start with Linux Shell Execute on web. Then copy-paste the given link to the browser. Or run
teleconsole join <given id> on your Linux/Mac terminal. Run
telec to see if it’s running, check other commands like
Teleconsole IS NOT started automatically. You need to start it from web. Given session ID is almost impossible to guess, it’s alsmost like to guess a private key for your Bitcoin wallet. Treat it like a random login and password.
If you don’t connect for 60 minutes the link will expire and Teleconsole Daemon will be terminated on the rig.
After you are done with Teleconsole 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 run the following command before installation:
ln -s /usr/lib/libcurl-gnutls.so.4 /usr/lib/libcurl.so.5
You can use FARMHASH to add your ASIC workers automatically without entering rig ID and password. Copy your FARMHASH from the Settings tab of your Farm and enter it into the command line as shown below:
cd /tmp && curl -L --insecure -s -O https://raw.githubusercontent.com/minershive/hiveos-asic/master/hive/bin/selfupgrade && FARM_HASH=your_hash_from_web sh selfupgrade
your_hash_from_web with your
For more details regarding ASIC installation, please refer to this GitHub page.
As soon as your worker connects to the dashboard, you’re all done! Your worker should now be ready for you to make a few final adjustments in the dashboard, which we will describe in our next article.