# Установка системы на USB носитель (Bootable USB)

Перед началом загрузите образ диска с расширением .raw. Сделать это можно [здесь](https://www.mikopbx.ru/download/).

{% embed url="<https://rutube.ru/video/f1e4397d8a46235b50cc814dfef5046f/>" %}

## Установка системы на USB-носитель

### Windows

{% hint style="danger" %}
Размер USB-носителя должен быть не менее 1 ГБ. **Все данные на USB-носителе будут удалены!**
{% endhint %}

В данной инструкции будет использоваться утилита balenaEtcher. Скачать можно [по ссылке](https://etcher.balena.io/).

1. Первым делом, отформатируйте Ваш USB-носитель со следующими параметрами:

* **File system** - FAT32
* **Allocation unit size** - 8192 bytes

<figure><img src="/files/zNHaSTP7ciagw0PKZlMa" alt=""><figcaption><p>Форматирование USB-накопителя</p></figcaption></figure>

2. Откройте balenaEtcher. Нажмите "**Flash from file**" и выберите ранее загруженный .raw файл.

<figure><img src="/files/hM6lBgWKsAAr6TnavFGo" alt=""><figcaption><p>Опция "Flash from drive"</p></figcaption></figure>

3. Нажмите "**Select target**".

<figure><img src="/files/YNh75chSpFOG6r7txpbG" alt=""><figcaption><p>"Select target"</p></figcaption></figure>

4. Из списка выберите Ваш USB-носитель.

Нажмите "**Select 1**".

<figure><img src="/files/F9kg2Bgx0bhw2GBMqHn4" alt=""><figcaption><p>Выбор диска для записи</p></figcaption></figure>

5. Далее нажмите "Flash!"

<figure><img src="/files/6NjhC76JZy3pLjNjSgOC" alt=""><figcaption><p>Начало записи образа</p></figcaption></figure>

Дождитесь окончания записи. Далее перейдите к разделу "[Загрузка с USB-накопителя](#zagruzka-s-usb-nakopitelya)".

<figure><img src="/files/JBXmHS7GfAGgzBZy2cVr" alt=""><figcaption><p>Успешная запись образа</p></figcaption></figure>

### MacOS

1. Подключите Ваш usb-носитель и откройте Terminal.

{% hint style="danger" %}
Размер USB-носителя должен быть не менее 1 ГБ. **Все данные на USB-носителе будут удалены!**
{% endhint %}

2. Выполните команду:

```bash
diskutil list
```

Будет отображена информация про все подключенные диски. Нас интересует диск с маркировкой **(external, physical)**. В нашем случае это **disk4, в Вашем случае номер может быть другим**. Используйте его номер для выполнения дальнейших шагов в этой инструкции.

<figure><img src="/files/pfrkuO6H7QZSGeQHlKFR" alt=""><figcaption><p>Вывод команды diskutil list</p></figcaption></figure>

3. Далее необходимо отформатировать USB носитель. Для этого используйте команду:

```bash
sudo diskutil eraseDisk FAT32 NONAME  MBRFormat /dev/disk4;
```

{% hint style="danger" %}
**Все данные на диске будут удалены!** Еще раз проверьте название диска который Вы форматируете!
{% endhint %}

Для подтверждения введите пароль администратора, дождитесь окончания форматирования.

<figure><img src="/files/qUsR0LVLSbS5kVZdLjik" alt=""><figcaption><p>Форматирование диска</p></figcaption></figure>

4. Отмонтируйте (отключите) диск, используя следующую команду:

```bash
sudo diskutil unmountDisk /dev/disk4;
```

<figure><img src="/files/oubzYcClnULBIROn9NJM" alt=""><figcaption><p>Отключение диска (команда unmountDisk)</p></figcaption></figure>

5. Запишите образ на USB-носитель, используя следующую команду:

```bash
sudo dd if=mikopbx-2024.1.114-x86_64.raw of=/dev/disk4 bs=1m;
```

Дождитесь окончания записи образа. Далее перейдите к разделу "[Загрузка с USB-накопителя](#zagruzka-s-usb-nakopitelya)".

<figure><img src="/files/dhOPJk5GrPzEhbxq14XO" alt=""><figcaption><p>Успешная запись образа</p></figcaption></figure>

### Linux

В данной инструкции в качестве примера, запись образа будет произведена на Ubuntu 24.04.

1. Подключите Ваш usb-носитель и откройте Terminal.

{% hint style="danger" %}
Размер USB-носителя должен быть не менее 1 ГБ. **Все данные на USB-носителе будут удалены!**
{% endhint %}

2. Выполните команду:

```bash
lsblk
```

Будет отображена информация про все подключенные диска. Найдите в этом списке Ваш usb-носитель и запомните его наименование. В нашем случае, это диск sdb.

<figure><img src="/files/AWOhMGX1fX2DOOnYhEF8" alt=""><figcaption><p>Список всех подключенных дисков</p></figcaption></figure>

3. Далее необходимо отформатировать usb-носитель, используя следующую команду:

```bash
sudo mkfs.vfat -F 32 -n NONAME /dev/sdb
```

{% hint style="danger" %}
**Все данные на диске будут удалены!** Еще раз проверьте название диска который Вы форматируете!
{% endhint %}

Для подтверждения введите пароль администратора, дождитесь окончания форматирования.

<figure><img src="/files/Wjaa51lZp1PwlhEgWkpm" alt=""><figcaption><p>Форматирование диска</p></figcaption></figure>

4. Отмонтируйте (отключите) диск, используя следующую команду:

```bash
sudo umount /dev/sdb*
```

<figure><img src="/files/sK4IY5nWdN2NRuLRV2uP" alt=""><figcaption><p>Команда "umount"</p></figcaption></figure>

5. Запишите образ на USB-носитель, используя следующую команду:

```bash
sudo dd if=mikopbx-2024.1.114-x86_64.raw of=/dev/sdb bs=1M
```

<figure><img src="/files/6zpuM00faqBqfjzQ8f7q" alt=""><figcaption><p>Успешно записанный образ</p></figcaption></figure>

Дождитесь окончания записи образа. Далее перейдите к разделу "[Загрузка с USB-накопителя](#zagruzka-s-usb-nakopitelya)".

## Загрузка с USB-накопителя

1. Запуститесь с USB-носителя. При возникновении ошибок (черный экран) - убидитесь, что:

* **Secure Boot** - Disabled
* **CSM (Compatibility Support Module)** - Enabled

<figure><img src="/files/zd0Hr7enAYL5XZdAe3QW" alt=""><figcaption><p>Загрузка с USB-носителя</p></figcaption></figure>

2. Система успешно загружена, но не подключен диск для хранения записей разговоров. Для его подключения, передвигаясь стрелочками на клавиатуре, перейдите в пункт "\[6] Data storage" и нажмите Enter.

<figure><img src="/files/gd0pGlqkMELRbMdyCKnf" alt=""><figcaption><p>Раздел "Data Storage"</p></figcaption></figure>

3. Далее выберите пункт "**Mount drive as data storage**" для подключения диска.

<figure><img src="/files/4vISi6es6oMgQVPbwJGQ" alt=""><figcaption><p>Выбор действия</p></figcaption></figure>

4. Выберите диск, который будет использоваться для хранения записей разговоров. Для этого введите его ID (название), например sdc в нашем случае.

Нажмите Enter.

<figure><img src="/files/98uGCkf7qQHNfkDPv2uA" alt=""><figcaption><p>Выбор диска</p></figcaption></figure>

5. После этого система перезагрузится и будет готова к работе и первой авторизации в Web-интерфейс.

<figure><img src="/files/25HUK9V59bto6aGIyfl7" alt=""><figcaption><p>Успешно установленная система</p></figcaption></figure>

Для перехода в Web-интерфейс, введите IP-адрес Вашей MikoPBX в строку браузера. Используйте стандартные данные для авторизации.

{% hint style="success" %}
Данные для первого входа в Web-интерфейс:

Логин: admin

Пароль: admin
{% endhint %}

<figure><img src="/files/n8OMukB9YrQxNB4H7mBc" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mikopbx.com/mikopbx/setup/bare-metal/bootable-usb.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
