#############
Быстрый старт
############# 

.. contents::
  :local:
  :depth: 2

**********************
Установка Braiins OS+
**********************

============================================
Стоковая прошивка, выпущенная до 2019 года
============================================

**Установка на одного устройство**

Вы можете легко установить Braiins OS+ через веб-интерфейс. Для этого выполните следующие действия:

  * Скачайте **ВЕБ-ПАКЕТ** с нашего `веб-сайта <https://braiins-os.com/plus/download/>`_.
  * Зайди на свой майнер и зайди в раздел *System -> Upgrade*.
  * Загрузите загруженный пакет и прошейте образ.

Braiins OS+ будет установлен на майнер. Конфигурация сети (например, статический IP-адрес), а также пул и пользовательские настройки будут автоматически перенесены в Braiins OS+, и автонастройка будет включена.

**Установка на несколько устройств**

Установка Braiins OS+ может быть легко выполнена с помощью BOS+ Toolbox. Для этого выполните следующие действия:

  * Скачайте **BOS+ Toolbox** с нашего `веб-сайта <https://braiins-os.com/plus/download/>`_.
  * Создайте новый текстовый файл, измените ".txt" окончание на ".csv" и вставьте IP-адреса, на которых вы хотите выполнить команды. Поместите этот файл в каталог, где находится BOS+ Toolbox. Используйте только один IP-адрес в строке!
  * После того, как вы загрузили BOS+ Toolbox, откройте командную строку (например, CMD для Windows, Terminal для Ubuntu и т.д.)
  * Замените *FILE_PATH_TO_BOS+_TOOLBOX* заполнитель в приведенной ниже команде с фактическим путем к файлу, в котором вы сохранили BOS+ Toolbox. Затем переключитесь на путь к файлу, выполнив команду: ::

      cd FILE_PATH_TO_BOS+_TOOLBOX

  * Теперь замените *listOfMiners.csv* заполнитель с вашим именем файла в команде ниже и выполните соответствующую команду для вашей операционной системы:

    Для командной строки **Windows**: ::

      bos-plus-toolbox.exe install --batch listOfMiners.csv

    Для командной строки **Linux**: ::
      
      ./bos-plus-toolbox install --batch listOfMiners.csv		

    **Примечание:** *при использовании BOS+ Toolbox для Linux вам нужно сделать его исполняемым с помощью следующей команды (это нужно сделать только один раз):* ::
  
      chmod u+x ./bos-plus-toolbox  

Braiins OS+ будет установлен на майнер. Конфигурация сети (например, статический IP-адрес), а также пул и пользовательские настройки будут автоматически перенесены в Braiins OS+, и автонастройка будет включена.

Для получения дополнительной информации об этом процессе, а также для получения дополнительных опции посетите разделы :ref:`bosbox` и :ref:`bosbox_install`.

==================================================
Стоковая прошивка, выпущенная в 2019 или позже
==================================================

Если вы используете стоковую прошивку, выпущенную в 2019 году или позже, единственный способ установить Braiins OS+ - это вставить SD-карту с прошивкой Braiins OS+. В 2019 году SSH-соединение было заблокировано, и проверка подписи в веб-интерфейсе не позволяет использовать микропрограммы сторонних производителей.

Чтобы установить Braiins OS+ с помощью SD-карты, выполните следующие действия:

 * Загрузите образ SD-карты с нашего `веб-сайта <https://braiins-os.com/plus/download/>`_.
 * Прошить загруженное изображение на SD-карту (например с помощью `Etcher <https://etcher.io/>`_). *Примечание: Простое копирование на SD-карту не будет работать. SD-карта должна быть перепрошита!*
 * Настройте джампер для загрузки с SD-карты (вместо памяти NAND), как показано ниже.

  .. |pic1| image:: ../_static/s9-jumpers.png
      :width: 45%
      :alt: S9 Jumpers

  .. |pic2| image:: ../_static/s9-jumpers-board.png
      :width: 45%
      :alt: S9 Jumpers Board

  |pic1|  |pic2|

 * Вставьте SD-карту в устройство, затем запустите устройство.
 * Через некоторое время вы сможете получить доступ к интерфейсу Braiins OS+ через IP-адрес устройства.
 * *[Необязательно]:* Теперь вы можете установить Braiins OS+ во внутреннюю память (NAND), следуя разделу :ref:`sd_nand_install`.

Для получения дополнительной информации об этом процессе, а также для получения дополнительных опции посетите разделы :ref:`sd` и :ref:`sd_install`.

***********************
Обновление Braiins OS+
***********************

**Обновление одного устройства**

Прошивка периодически проверяет наличие новой версии. В случае появления новой версии в веб-интерфейсе с правой стороны верхней панели появляется синяя кнопка **Upgrade**. Нажмите кнопку и подтвердите, чтобы начать обновление.

Кроме того, вы можете обновить информацию о хранилище вручную, нажав кнопку *Обновить списки* в меню System > Software. Если кнопка отсутствует, попробуйте обновить страницу. Чтобы запустить процесс обновления, введите ``firmware`` в поле *Download and install package* и нажмите *OK*.

**Обновление нескольких устройств**

Обновление Braiins OS+ на нескольких устройствах одновременно можно легко выполнить с помощью **BOS+ Toolbox**. Для этого выполните следующие действия:

  * Скачайте **BOS+ Toolbox** с нашего `веб-сайта <https://braiins-os.com/plus/download/>`_.
  * Создайте новый текстовый файл, измените ".txt" окончание на ".csv" и вставьте IP-адреса, на которых вы хотите выполнить команды. Поместите этот файл в каталог, где находится BOS+ Toolbox. Используйте только один IP-адрес в строке!
  * После того, как вы загрузили BOS+ Toolbox, откройте командную строку (например, CMD для Windows, Terminal для Ubuntu и т.д.)
  * Замените *FILE_PATH_TO_BOS+_TOOLBOX* заполнитель в приведенной ниже команде с фактическим путем к файлу, в котором вы сохранили BOS+ Toolbox. Затем переключитесь на путь к файлу, выполнив команду: ::

      cd FILE_PATH_TO_BOS+_TOOLBOX

  * Теперь замените *listOfMiners.csv* заполнитель с вашим именем файла в команде ниже и выполните соответствующую команду для вашей операционной системы:

    Для командной строки **Windows**: ::

      bos-plus-toolbox.exe update --batch listOfMiners.csv

    Для командной строки **Linux**: ::
      
      ./bos-plus-toolbox update --batch listOfMiners.csv		

    **Примечание:** *при использовании BOS+ Toolbox для Linux вам нужно сделать его исполняемым с помощью следующей команды (это нужно сделать только один раз):* ::
  
      chmod u+x ./bos-plus-toolbox 

Эта команда будет искать обновление для майнеров, указанных в *listOfMiners.csv*, и обновлять их, если есть новая версия прошивки.

Для получения дополнительной информации об этом процессе, а также для получения дополнительных опции посетите разделы :ref:`bosbox` и :ref:`bosbox_install`.

**************************
Деинсталляция Braiins OS+
**************************

**Деинсталляция одного устройства**

Вы можете легко удалить Braiins OS+ на одном устройстве, используя **BOS+ Toolbox**. Для этого выполните следующие действия:

  * Скачайте **BOS+ Toolbox** с нашего `веб-сайта <https://braiins-os.com/plus/download/>`_.
  * Создайте новый текстовый файл, измените ".txt" окончание на ".csv" и вставьте IP-адреса, на которых вы хотите выполнить команды. Поместите этот файл в каталог, где находится BOS+ Toolbox. Используйте только один IP-адрес в строке!
  * После того, как вы загрузили BOS+ Toolbox, откройте командную строку (например, CMD для Windows, Terminal для Ubuntu и т.д.)
  * Замените *FILE_PATH_TO_BOS+_TOOLBOX* заполнитель в приведенной ниже команде с фактическим путем к файлу, в котором вы сохранили BOS+ Toolbox. Затем переключитесь на путь к файлу, выполнив команду: ::

      cd FILE_PATH_TO_BOS+_TOOLBOX

  * Теперь замените *listOfMiners.csv* заполнитель с вашим именем файла в команде ниже и выполните соответствующую команду для вашей операционной системы:

    Для командной строки **Windows**: ::

      bos-plus-toolbox.exe uninstall IP_ADDRESS

    Для командной строки **Linux**: ::
      
      ./bos-plus-toolbox uninstall IP_ADDRESS

    **Примечание:** *при использовании BOS+ Toolbox для Linux вам нужно сделать его исполняемым с помощью следующей команды (это нужно сделать только один раз):* ::
  
      chmod u+x ./bos-plus-toolbox 
      
Это вернет устройство к стоковой прошивке. Автоматически установится более старая версия, где SSH не был заблокирован, так что вы можете получить удаленный доступ к вашему майнеру.

**Деинсталляция нескольких устройств**

Вы можете легко удалить Braiins OS+ на одном устройстве, используя **BOS+ Toolbox**. Для этого выполните следующие действия:

  * Скачайте **BOS+ Toolbox** с нашего `веб-сайта <https://braiins-os.com/plus/download/>`_.
  * Создайте новый текстовый файл, измените ".txt" окончание на ".csv" и вставьте IP-адреса, на которых вы хотите выполнить команды. Поместите этот файл в каталог, где находится BOS+ Toolbox. Используйте только один IP-адрес в строке!
  * После того, как вы загрузили BOS+ Toolbox, откройте командную строку (например, CMD для Windows, Terminal для Ubuntu и т.д.)
  * Замените *FILE_PATH_TO_BOS+_TOOLBOX* заполнитель в приведенной ниже команде с фактическим путем к файлу, в котором вы сохранили BOS+ Toolbox. Затем переключитесь на путь к файлу, выполнив команду: ::

      cd FILE_PATH_TO_BOS+_TOOLBOX

  * Теперь замените *listOfMiners.csv* заполнитель с вашим именем файла в команде ниже и выполните соответствующую команду для вашей операционной системы:

    Для командной строки **Windows**: ::

      bos-plus-toolbox.exe uninstall --batch listOfMiners.csv

    Для командной строки **Linux**: ::
      
       ./bos-plus-toolbox uninstall --batch listOfMiners.csv

    **Примечание:** *при использовании BOS+ Toolbox для Linux вам нужно сделать его исполняемым с помощью следующей команды (это нужно сделать только один раз):* ::
  
      chmod u+x ./bos-plus-toolbox 
      
Это вернет устройство к стоковой прошивке. Автоматически установится более старая версия, где SSH не был заблокирован, так что вы можете получить удаленный доступ к вашему майнеру.

Для получения дополнительной информации об этом процессе, а также для получения дополнительных опции посетите разделы :ref:`bosbox` and :ref:`bosbox_uninstall`.

**********************
Настройка Braiins OS+
**********************

**Конфигурация одного устройства**

Вы можете настроить Braiins OS+ на одном устройстве с помощью **веб-интерфейса** майнера или непосредственно в файле конфигурации, расположенном в **/etc/bosminer.toml** (для получения дополнительной информации посетитеe секцию :ref:`configuration`).

**Конфигурация нескольких устройств**

Вы можете легко настроить Braiins OS+ на нескольких устройствах, используя **BOS+ Toolbox**. Для этого следуйте инструкциям в разделе :ref:`bosbox_configure`.