> For the complete documentation index, see [llms.txt](https://docs.mikopbx.com/mikopbx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mikopbx.com/mikopbx/manual/maintenance/update/bare-metal.md). # Обновление физического сервера Обновление MikoPBX, установленной на отдельный физический компьютер {% hint style="warning" %} Рекомендуется производить обновления последовательно, «не перепрыгивая» через релизы и версии. {% endhint %} Эта инструкция подходит для отдельного компьютера или сервера, на котором установлена MikoPBX. Основной способ - обновление через web-интерфейс. Если станция не загружается штатно или web-интерфейс недоступен, используйте ISO-образ, записанный на отдельный USB-носитель. {% hint style="danger" %} Перед обновлением обязательно создайте резервную копию настроек и сохраните её на другом устройстве. Так же сохраните копию записей разговоров. {% endhint %} ## Подготовка 1. Убедитесь, что у вас есть физический доступ к серверу либо рабочая консоль. Создайте резервную копию настроек MikoPBX и записей разговоров. 2. Убедитесь, что в Storage свободно не менее **400 МБ**. 3. Завершите активные вызовы и запланируйте перерыв в работе телефонии. ## Обновление заменой Bootable USB Для физического сервера с отдельным диском Storage рекомендуемый режим работы — постоянная загрузка MikoPBX с [Bootable USB](/mikopbx/setup/bare-metal/bootable-usb.md). Система размещается на USB-носителе, а записи разговоров, история вызовов, модули и другие рабочие данные хранятся на HDD или SSD, подключённом как Storage. При такой установке обновление можно выполнить заменой загрузочного USB-носителя: 1. Создайте резервную копию настроек MikoPBX и сохраните её на другом устройстве. Дополнительно создайте резервную копию диска Storage. 2. После последнего изменения настроек подождите не менее 5 минут. MikoPBX сохраняет служебную копию базы настроек на Storage каждые 5 минут, и именно её новая система использует для автоматического восстановления. 3. Скачайте RAW-образ требуемой версии с [официальной страницы загрузки MikoPBX](https://www.mikopbx.ru/download/) и запишите его на **другой** USB-носитель по [инструкции Bootable USB](/mikopbx/setup/bare-metal/bootable-usb.md#ustanovka-sistemy-na-usb-nositel). Архитектура образа должна совпадать с архитектурой сервера. 4. Корректно выключите сервер. Отключите старый Bootable USB, подключите новый, а диск Storage оставьте подключённым. Проверьте порядок загрузки в BIOS/UEFI. 5. Запустите сервер. Новая MikoPBX увидит заводскую конфигурацию, найдёт на Storage свежую служебную копию, восстановит `/cf/conf/mikopbx.db` и автоматически перезагрузится. Не выключайте сервер во время этого процесса. 6. После повторной загрузки проверьте версию MikoPBX, сетевые настройки, внутренние номера, провайдеров, маршруты, историю вызовов, записи разговоров и модули. 7. Сохраните старый USB-носитель и резервную копию Storage до завершения проверки и создания новой резервной копии обновлённой станции. {% hint style="info" %} Новый USB-носитель содержит новую систему. Из Storage автоматически восстанавливается база настроек, а остальные данные продолжают использоваться непосредственно с диска Storage. После успешного восстановления первая загрузка завершается дополнительной автоматической перезагрузкой. {% endhint %} {% hint style="danger" %} Не перезаписывайте старый Bootable USB: он является одной из точек отката. Однако одного старого USB недостаточно для гарантированного возврата на прежнюю версию, поскольку новая MikoPBX могла изменить данные на Storage. Для надёжного отката необходима резервная копия Storage, созданная до обновления. {% endhint %} ## Обновление через web-интерфейс ### Онлайн-обновление 1. В web-интерфейсе откройте "**Обслуживание"** → "**Обновление PBX"**.

Раздел "Обновление PBX"

2. Выберите желаемую версию в списке. Ознакомьтесь со списком изменений и запустите процесс обновления.

Кнопка для обновления станции из веб интерфейса

3. После загрузки введите фразу **Да, у меня есть резервная копия**. Нажмите **Обновить**.

Подтверждение наличия резервной копии

### Обновление локальным IMG-файлом 1. Скачайте `.img` нужной версии со страницы [релизов MikoPBX](https://github.com/mikopbx/Core/releases). {% hint style="info" %} Обратите внимание на архитектуру Вашей MikoPBX: в случае если у Вас ARM MikoPBX, то используйте файл обновления с "arm64" в названии. Если у Вас X86 MikoPBX, то используйте файл обновления с "x86\_64" в названии. {% endhint %}

Загрузка .img для обновления

2. Откройте **Обслуживание** → **Обновление PBX**.

Раздел "Обновление PBX"

3. Выберите скачанный файл `.img`.

Выбор файла обновления

4. Нажмите **Применить обновление**.

Кнопка для применения обновления

4. Введите фразу **Да, у меня есть резервная копия** и подтвердите операцию.

Подтверждение наличии резервной копии станции

Дождитесь автоматической перезагрузки станции после обновления.

Станция на новой версии

## Обновление с ISO на USB-носителе Этот способ подходит для восстановления и обновления станции с локальной консоли. ### Создание загрузочного носителя 1. Скачайте ISO нужной версии со страницы [релизов MikoPBX](https://github.com/mikopbx/Core/releases). {% hint style="info" %} Обратите внимание на архитектуру Вашей MikoPBX: в случае если у Вас ARM MikoPBX, то используйте файл обновления с "arm64" в названии. Если у Вас X86 MikoPBX, то используйте файл обновления с "x86\_64" в названии. {% endhint %}
2. Подключите отдельную USB-флешку объёмом не менее 1 ГБ. 3. Запишите ISO в режиме образа диска с помощью Rufus, balenaEtcher или `dd`. Инструкцию по записи ISO образа Вы можете найти [здесь](/mikopbx/setup/bare-metal/live-usb.md#zapis-obraza-na-usb-nositel). {% hint style="danger" %} При записи ISO все данные на выбранной USB-флешке будут удалены. Внимательно проверьте выбранное устройство. {% endhint %} ### Запуск обновления 1. Подключите подготовленную флешку к серверу. В BIOS/UEFI или Boot Menu выберите загрузку с USB. 2. Дождитесь запуска MikoPBX в Recovery mode.

MikoPBX в Recovery Mode

3. Нажмите на любую клавишу, чтобы перейти к консольному меню. Далее откройте **"\[4] Install or recover"**.

Раздел "Install or recover" в консольном меню MikoPBX

4. Выберите **"2) Update to version...".** {% hint style="info" %} Пункт **Install** предназначен для новой установки и удаляет данные на выбранном устройстве. Для обновления с сохранением настроек выбирайте только "**Update to version..."** {% endhint %}

Обновление версии на 2026.3.40

5. Дождитесь окончания записи и перезагрузки. Извлеките USB-флешку либо верните системный диск на первое место в порядке загрузки.

Успешное обновление станции на версию 2026.3.40

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs.mikopbx.com/mikopbx/manual/maintenance/update/bare-metal.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.