Getting Started with Hive OS — Adding A Custom Miner
![]()
Hive OS supports several popular miner algorithms, but not every single one. For this purpose we added a new feature called Custom Miner Integration that allows users to add a miner that’s not “baked” into the distribution image of the OS. You have the option to either install a pre-created package or create one yourself. But in this guide we’ll mostly cover the steps required to install a pre-created package.
Installing A Custom Miner
Start by going to the custom miner download page and simply copy the URL to the file.
To install a custom archive manually on the rig you can download it and unpack it to /hive/custom folder. Do note that even though you did copy it locally you will still need the URL for the Flight Sheet to work.
Setting Up The Flight Sheet
We covered the process of creating a Flight Sheets and Wallets, which you will also require, in one of our previous articles, so we won’t go into the details, assuming you already know how to do it.
Got to the Flight Sheets tab in your farm’s Dashboard. In the Add New Flight Sheet section, start filling in the following fields:
- Flight Sheet Name — use a name that will describe the Flight Sheet’s purpose best. For example, ETH on nanopool using claymore; flypool zcash on dstm; etc.
- Coin — this works like a filter, you can see only wallets, pools and miners only for the chosen coin. For example, if you choose ETH the filter will hide all your pre-created wallets and pools that don’t support or aren’t associated with that coin.
- Wallet — choose a wallet for this Flight Sheet. These are the wallets you created in the Wallets tab.
- Pool — select Configure in miner for the Custom miner option in the Miner field to show-up.
- Miner — select Custom and then click the Setup Miner Config for miner specific settings then fill in the necessary fields. Note, each miner can have a different set of parameters and required fields.
Because we’re setting up a Custom miner we need to manually configure these settings via the Setup Miner Config window. Click Setup Miner Config button in Miner and fill in the following fields:
- Miner name — use the same name as the package. For example: if the package name is phoenixminer-3.5_c.tar.gz , then the miner name must be phoenixminer .
- Installation URL — the direct URL to the miner package.
- Hash algorithm — choose the hash algorithm for the miner.
- Wallet and worker template — this will depend on your miner specific configuration
- Pool URL — the pool’s address and also the pool specific settings like passwords, wallets, and ports. Note, we recommend typing the values in the following format: WALLET: %WAL%, WORKER:%WORKER_NAME% . Also all values should be separated by a comma.
- Pass — x a default setting, usually left as is.
- Extra config arguments — these are miner specific and are optional. Note, these may be important in certain cases, so we recommend reading your miner’s documentation for additional details.
- Click Apply Changes and you’re all done
Once you’re done click the Create Flight Sheet button. You can now apply the Flight Sheet you’ve created.
Example: Adding and Setting-up Phoenix Miner
Now that we showed you how to setup a custom miner, let’s put it to practice by setting-up Phoenix Miner 3.5c on Hiveon Pool using the ethash miner algorithm as an example.
In the Add New Flight Sheet section, start filling in the following fields:
- Coin — ETH
- Wallet — Example ETH wallet we created.
- Pool — select Configure in miner for the Custom miner option in the Miner field to show-up.
- Miner — select Custom and then click the Setup Miner Config for miner specific settings then fill in the necessary fields. Note, each miner can have a different set of parameters and required fields.
- Flight Sheet Name — Phoenix on Hiveon
Now we need to configure the miner. Click Setup Miner Config button in Miner and fill in the following fields:
- Miner name — we’ll call it phoenixminer
- Installation URL — adding the URL of the package http://download.hiveos.farm/custom/phoenixminer-3.5_c.tar.gz
- Hash algorithm — select ethash from the dropdown list.
- Wallet and worker template — type null , as we’re using an ETH wallet we already have.
- Pool URL — we’ll be using Hiveon pool:
POOL: eu-eth.hiveon.net:4444, WALLET: %WAL%, WORKER:%WORKER_NAME%
POOL: eu-eth.hiveon.net:14444, WALLET: %WAL%, WORKER:%WORKER_NAME% - Pass — set to x
- Extra config arguments — in our case we leave this field blank.
- Click Apply Changes and you’re all done.
How build your own package?
Hive 2.0 supports custom miners that you can “cook” yourself and you’ll need to implement using several easy scripts in order to get your miner to work and send stats to Hive. We won’t cover the process of creating these scripts in this article though.
If you don’t see a specific miner you’d like to use on our custom miner download page, check the Custom Miner Integration forum thread for more packages that our enthusiasts have created to be used with Hive OS.
Additionally, you can refer to the custom miner integration Readme on GitHub for script templates and examples on how to create and integrate your own miner.
Hive OS 2.0 — интеграция пользовательского майнера
Hive OS поддерживает несколько популярных алгоритмов, но не каждый. Для этой цели мы добавили новую функцию Custom Miner Integration, которая позволяет пользователям добавлять майнеры, которые не вошли в образ дистрибутива ОС . У вас есть возможность либо установить предварительно созданный пакет, либо создать его самостоятельно. Но в этом руководстве мы в основном рассмотрим шаги, необходимые для установки предварительно созданного пакета.
Установка пользовательского майнера
Начните с перехода на пользовательскую страницу загрузки майнера или просто скопируйте URL-адрес файла.

Пользовательский репозиторий майнеров
Чтобы установить собственный архив вручную на платформе, вы можете загрузить его и распаковать в / hive / custom folder . Обратите внимание, что даже если вы скопировали его локально, вам все равно понадобится URL-адрес для полетного листа.
Настройка полетного листа
Мы рассмотрели процесс создания полетных листов и кошельков, которые вам также потребуются, в одной из наших предыдущих статей, поэтому мы не будем вдаваться в подробности, предполагая, что вы уже знаете, как это сделать.
Перейдите на вкладку «Полетные листы» в панели управления вашей фермы. В разделе «Добавить новый лист» начните заполнять следующие поля:
- Имя полетного листа — используйте имя, которое лучше всего описывает цель полетного листа. Например, ETH на нанопуле с использованием clymore; flypool zcash на dstm; и т.п.
- Монета — это работает как фильтр, вы можете видеть только кошельки, пулы и майнеры только для выбранной монеты. Например, если вы выберете ETH, фильтр скроет все ваши предварительно созданные кошельки и пулы, которые не поддерживают или не связаны с этой монетой.
- Кошелек — выберите кошелек для этого листа рейса. Это кошельки, созданные на вкладке «Кошельки».
- Пул — выберите «Настроить в майнере» для параметра «Пользовательский майнер».
- Майнер — выберите «Пользовательский», а затем нажмите «Настройка майнера», чтобы указать параметры, заданные пользователем, а затем заполните необходимые поля. Обратите внимание, что каждый майнер может иметь другой набор параметров и требуемых полей.
Поскольку мы настраиваем произвольный майнер, нам нужно вручную настроить эти параметры с помощью окна Настройки конфигурация майнера. Нажмите кнопку «Настройка конфигурации майнера» и заполните следующие поля:
- Имя майнера — используйте оригинальное имя. Например: если имя phoenixminer-3.5_c.tar.gz, тогда имя должно быть phoenixminer.
- URL установки — прямой URL-адрес где находится сам майнер в репозитории.
- Хэш-алгоритм — выберите хэш-алгоритм.
- Кошелек и рабочий шаблон — это будет зависеть от вашей конкретной конфигурации
- URL-адрес пула — адрес пула, а также определенные параметры пула, такие как пароли, кошельки и порты. Обратите внимание, что мы рекомендуем вводить значения в следующем формате: WALLET:% WAL%, WORKER:% WORKER_NAME%. Также все значения должны быть разделены запятой.
- Pass — x значение по умолчанию, обычно оставленное как есть.
- Дополнительные аргументы конфигурации — они являются специфичными для пользователя и являются необязательными. Обратите внимание, что это может быть важно в некоторых случаях, поэтому мы рекомендуем прочитать дополнительную информацию о вашей майнере.
Нажмите «Применить изменения», и все готово.
После того, как вы закончите, нажмите кнопку «Создать полетный лист».
Пример: Добавление и настройка Phoenix Miner
Теперь, когда мы показали вам, как настроить пользовательский майнер, давайте добавим его на практике, установив Phoenix Miner 3.5c в Hiveon Pool, используя алгоритм ethash miner в качестве примера.
В разделе «Добавить новый лист полета» начните заполнять следующие поля:
- Монета — ETH
- Кошелек — пример кошелька ETH, который мы создали.
- Пул — выберите «Настроить в шахтере» для параметра «Пользовательский майнер» в поле «Шахтер» для отображения.
- Майнер — выберите «Пользовательский», а затем нажмите «Настройка Miner Config», чтобы указать параметры, заданные пользователем, а затем заполните необходимые поля. Обратите внимание, что каждый шахтер может иметь другой набор параметров и требуемых полей.
- Название листа — Phoenix on Hiveon
Теперь нам нужно настроить майнер. Нажмите кнопку «Настройка конфигурации майнера»и заполните следующие поля:
- Имя шахтера — назовем это phoenixminer
- URL установки — добавление URL-адреса пакета http://download.hiveos.farm/custom/phoenixminer-3.5_c.tar.gz
- Хэш-алгоритм — выберите ethash из выпадающего списка.
- Кошелек и рабочий шаблон — введите null, поскольку мы используем кошелек ETH, который у нас уже есть.
- URL пула — мы будем использовать пул хивеонов:
POOL: eueth.hiveon.net:4444, WALLET:% WAL%, WORKER:% WORKER_NAME%
POOL: eueth.hiveon.net:14444, WALLET:% WAL%, WORKER:% WORKER_NAME% - Pass — установлен на x
- Дополнительные аргументы конфигурации — в нашем случае мы оставляем это поле пустым.
Нажмите «Применить изменения», и все готово.
Как создать собственный пакет с майнером?
Hive 2.0 поддерживает настраиваемые майнеры, которые вы можете «собрать» самостоятельно, и вам нужно будет реализовать несколько простых сценариев, чтобы заставить вашего майнера работать и отправлять статистику в Hive. Однако мы не будем описывать процесс создания этих сценариев в этой статье.
Если вы не видите конкретный майнер, который хотите использовать на нашей странице загрузки пользовательских майнеров, проверьте поток форума Custom Miner Integration для большего количества пакетов, созданных нашими энтузиастами для использования с ОС Hive.
Кроме того, вы можете обратиться к документации для пользовательской интеграции Miner Readme на GitHub для шаблонов сценариев и примеры того, как создавать и интегрировать свой собственный майнер.
Настройка HIVE OS — как добавить майнер, которого нет в системе?

Страница HIVE OS с кастомными майнерами.
Для установки архива вручную: скачайте и распакуйте содержимое архива в папку /hive/custom . Учтите, что даже скопировав и распаковав архив самостоятельно, вам всё равно придется указать ссылку на архив с майнером, при настройке Полетного Листа.
2. Настройка Полетного Листа.
Перейдите на вкладку Полетные Листы, в панели управления вашими фермами, и начните заполнять форму для добавления нового полетного листа:
- Имя — название полетного листа в списке. Например: ETH на nanopool майнер claymore; flypool zcash on dstm; и т.д. Хотя и без заполнения этого поля полетные листы прекрасно читаются…
- Монета — либо выбирайте из списка, либо впишите название сами.
- Кошелек — выберите кошелек для монеты, если уже добавили, либо добавьте на данном этапе.
- Пул — выбирайте Настроить майнер.
- Майнер — выбирайте Custom и переходим в Конфиг. майнера, для настройки пользовательского майнера. Обратите внимание, что все майнеры разные, и имеют разные настройки!
3. Настройка майнера.
Так как мы настраиваем сторонний майнер, нам нужно сконфигурировать настройки самостоятельно, через окно Конфиг. майнера:
- Имя майнера — используйте название архива. Например: если архив назывался phoenixminer-3.5_c.tar.gz , то имя майнера надо указать как phoenixminer .
- Установочный URL — скопируйте прямую ссылку на нужный майнер из списка майнеров HIVE OS.
- Хеш алгоритм — выберите алгоритм для майнинга из списка, если он там есть. Если нет — то и не выбирайте
- Кошелек и воркер шаблона — зависит от настроек майнера. Но, скорее всего, как минимум %WAL% надо будет вписать.
- Адрес пула — адрес пула, а также настройки пула (урл и порты).
- Пароль — x как настройка по умолчанию, иногда указывается тикер монетки, если на пуле, на одном алгоритме, монет много. Иногда бывает указывается порог выплат. Зависит от настроек и возможностей пула.
- Дополнительные параметры конфигурации — специфические настройки майнеров, или пула. Например, указываются алгоритмы майнинга. Рекомендуем читать инструкцию к майнеру.
- Нажмите Применить изменения.
Закончив настройку, нажмите кнопку Создать полетный лист. Теперь им можно пользоваться!
4. Пример: как установить и настроить Phoenix Miner на HIVE OS?
Для примера показана настройка стороннего майнера Phoenix Miner 3.5c пул HIVE с алгоритмом ethash.
Adding a custom miner
Hiveon OS supports several popular miner algorithms, but not every single one. For this purpose we added a new feature called Custom Miner Integration that allows users to add a miner that’s not “baked” into the distribution image of the OS. You have the option to either install a pre-created package or create one yourself. But in this guide we’ll mostly cover the steps required to install a pre-created package.
Installing A Custom Miner
Start by going to the custom miner download page and simply copy the URL to the file.
Custom miner repository
To install a custom archive manually on the rig you can download it and unpack it to /hive/custom folder. Note that even though you did copy it locally you will still need the URL for the Flight Sheet to work.
Setting Up The Flight Sheet
We covered the process of creating a Flight Sheets and Wallets, which you will also require, in one of our previous articles, so we won’t go into the details, assuming you already know how to do it.
Got to the Flight Sheets tab in your farm’s Dashboard. In the Add New Flight Sheet section, start filling in the following fields:
- Flight Sheet Name — use a name that will describe the Flight Sheet’s purpose best. For example, ETH on nanopool using claymore; flypool zcash on dstm; etc.
- Coin — this works like a filter, you can see wallets, pools and miners only for the chosen coin. For example, if you choose ETH the filter will hide all your pre-created wallets and pools that don’t support or aren’t associated with that coin.
- Wallet — choose a wallet for this Flight Sheet. These are the wallets you created in the Wallets tab.
- Pool — select Configure in miner for the Custom miner option in the Miner field to show-up.
- Miner — select Custom and then click the Setup Miner Config for miner specific settings, then fill in the necessary fields. Note, each miner can have a different set of parameters and required fields.
Because we’re setting up a Custom miner we need to manually configure these settings via the Setup Miner Config window. Click Setup Miner Config button in Miner and fill in the following fields:
- Miner name — use the same name as the package. For example: if the package name is phoenixminer-3.5_c.tar.gz , then the miner name must be phoenixminer .
- Installation URL — the direct URL to the miner package.
- Hash algorithm — choose the hash algorithm for the miner.
- Wallet and worker template — this will depend on your miner specific configuration
- Pool URL — the pool’s address and also the pool specific settings like passwords, wallets, and ports. Note, we recommend typing the values in the following format: WALLET: %WAL%, WORKER:%WORKER_NAME% . Also all values should be separated by a comma.
- Pass — x a default setting, usually left as is.
- Extra config arguments — these are miner specific and are optional. Note, these may be important in certain cases, so we recommend reading your miner’s documentation for additional details.
- Click Apply Changes and you’re all done
Once you’re done click the Create Flight Sheet button. You can now apply the Flight Sheet you’ve created.
Example: Adding and Setting-up Phoenix Miner
Now that we showed you how to set up a custom miner, let’s put it to practice by setting-up Phoenix Miner 3.5c on Hiveon Pool using the ethash miner algorithm as an example.
Custom miner Flight Sheet
In the Add New Flight Sheet section, start filling in the following fields:
- Coin — ETH
- Wallet — Example ETH wallet we created.
- Pool — select Configure in miner for the Custom miner option in the Miner field to show-up.
- Miner — select Custom and then click the Setup Miner Config for miner specific settingsб then fill in the necessary fields. Note, each miner can have a different set of parameters and required fields.
- Flight Sheet Name — Phoenix on Hiveon

Custom miner configuration
Now we need to configure the miner. Click Setup Miner Config button in Miner and fill in the following fields:
- Miner name — we’ll call it phoenixminer
- Installation URL — adding the URL of the package https://download.hiveos.farm/custom/phoenixminer-3.5_c.tar.gz
- Hash algorithm — select ethash from the dropdown list
- Wallet and worker template — type null , as we’re using an ETH wallet we already have
- Pool URL — we’ll be using Hiveon Pool address
POOL: eu-eth.hiveon.net:4444, WALLET: %WAL%, WORKER:%WORKER_NAME%
POOL: eu-eth.hiveon.net:14444, WALLET: %WAL%, WORKER:%WORKER_NAME%
- Pass — set to x
- Extra config arguments — in our case we leave this field blank.
- Click Apply Changes and you’re all done.

How to build your own package?
Hive 2.0 supports custom miners that you can “cook” yourself and you’ll need to implement using several easy scripts in order to get your miner to work and send stats to Hive. Please take existing integrations as a starting point.
The integration documentation is here. To install custom archive manually you can just unpack it to /hive/miners/custom .
To install it from URL run /hive/miners/custom/custom-get url-to-your-superminer . Use “-f” argument at the end to reinstall it: /hive/miners/custom/custom-get url-to-your-superminer -f . Since v0.6 for updating Custom miner, it is just enough to change URL in your Flight Sheet for the new one.