> 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/cloud-virtual-machine.md). # Обновление в облаке Обновление MikoPBX, развернутой как виртуальная машина в облаке {% hint style="warning" %} Рекомендуется производить обновления последовательно, «не перепрыгивая» через релизы и версии. {% endhint %} Эта инструкция предназначена для MikoPBX, работающей как полноценная облачная виртуальная машина: из Marketplace либо из импортированного RAW, VHD или другого дискового образа. {% hint style="info" %} Встроенный механизм обновления рассчитан на штатную дисковую установку MikoPBX с загрузочным разделом, разделом конфигурации `/cf` и подключённым Storage. Он не предназначен для Docker и LXC. {% endhint %} Основной способ обновления облачной станции — через web-интерфейс с использованием `.img`-образа. Возможность загрузки с ISO зависит от конкретного облачного провайдера и не является универсальной. {% hint style="danger" %} Перед обновлением создайте две независимые точки восстановления: резервную копию настроек MikoPBX и snapshot системного диска или всей виртуальной машины в панели облачного провайдера. {% endhint %} ## Перед началом 1. Проверьте, что у вас есть доступ к панели управления облаком и web-интерфейсу MikoPBX. Сохраните резервную копию настроек MikoPBX, а так же записей разговоров вне обновляемой виртуальной машины. 2. Создайте snapshot системного диска. При наличии отдельного диска с записями создайте snapshot и для него либо используйте резервное копирование хранилища. 3. Запишите текущий внешний и внутренний IP-адреса, правила Security Group, подключённые диски и параметры сети. 4. Убедитесь, что на системном диске с MikoPBX свободно не менее **400 МБ**. 5. Запланируйте техническое окно: активные вызовы будут завершены. ## Обновление заменой виртуальной машины Для двухдисковой установки можно не обновлять системный диск существующей VM, а создать новую виртуальную машину с актуальной версией MikoPBX и подключить к ней копию прежнего диска Storage. {% hint style="info" %} При штатной работе MikoPBX сохраняет служебную копию базы настроек на Storage каждые 5 минут. Если новая система запускается с заводской конфигурацией, MikoPBX ищет эти копии на подключённых дисках, выбирает самую свежую, восстанавливает `/cf/conf/mikopbx.db`, проверяет целостность базы и перезагружается. Это не восстановление старого системного образа: операционная система остаётся новой. Записи разговоров, история вызовов, модули и другие данные не копируются обратно, а продолжают использоваться непосредственно с подключённого Storage. {% endhint %} ### Подготовка 1. Создайте резервную копию настроек средствами MikoPBX и скачайте её на компьютер. Резервная копия, сохранённая вне облака, нужна на случай, если служебная копия на Storage окажется недоступна или повреждена. 2. После последнего изменения настроек подождите не менее 5 минут, чтобы MikoPBX успела записать свежую служебную копию базы на Storage. 3. Завершите активные вызовы и остановите старую VM. Создайте snapshot отдельного диска Storage. Для надёжного отката также сохраните snapshot старого системного диска или всей VM. 4. Зафиксируйте параметры старой VM: архитектуру процессора, внутренний и публичный IP-адреса, подсеть, Security Group, тип и порядок подключения дисков. ### Создание и переключение ВМ 1. Создайте новую виртуальную машину с MikoPBX требуемой версии и той же архитектуры процессора. Например, в Yandex Cloud можно использовать доступный [образ MikoPBX из Marketplace](https://yandex.cloud/ru/marketplace/products/miko/mikopbx). 2. Не запускайте новую VM и не изменяйте её заводские настройки до подключения Storage. 3. Создайте из snapshot отдельный диск Storage и подключите его к новой VM как дополнительный диск. Snapshot должен сохранять исходную разметку, файловую систему и каталог `mikopbx/backup/db`. 4. Запустите новую VM. Во время первой загрузки MikoPBX обнаружит заводскую конфигурацию, найдёт служебную копию настроек на Storage и восстановит её. После успешного восстановления система автоматически перезагрузится ещё раз — не прерывайте этот процесс. 5. Войдите в web-интерфейс и проверьте: * установленную версию MikoPBX; * внутренние номера, провайдеров и маршруты; * подключение Storage; * историю вызовов, записи разговоров, звуковые файлы и модули; * сетевые настройки и доступность телефонии. 6. Оставив старую VM выключенной, перенесите её публичный IP-адрес на новую VM. Ещё раз проверьте входящие и исходящие вызовы. 7. Не удаляйте старую VM и snapshots до завершения проверки и создания свежей резервной копии уже обновлённой станции. ## Онлайн-обновление 1. Войдите в web-интерфейс MikoPBX. 2. Откройте "**Обслуживание"** → "**Обновление PBX"**.

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

3. Найдите необходимую версию в таблице "**Доступны онлайн обновления"**. Ознакомьтесь со списком изменений и запустите загрузку.
4. После завершения загрузки введите фразу "**Да, у меня есть резервная копия"**. Нажмите **Обновить**.

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

5. Не выполняйте Restart или Stop из панели облака: MikoPBX сама подготовит обновление и перезагрузится. Во время перезагрузки соединение с web-интерфейсом прервётся. Следить за процессом безопаснее через serial console или web console облачного провайдера. ## Обновление скачанным IMG-файлом Используйте локальный файл, если версия отсутствует в списке или облачная VM не имеет прямого доступа к серверу обновлений. 1. Скачайте `.img` нужной версии со страницы [релизов MikoPBX](https://github.com/mikopbx/Core/releases). {% hint style="info" %} Обратите внимание на архитектуру Вашей MikoPBX: в случае если у Вас ARM MikoPBX, то используйте файл обновления с "arm64" в названии. Если у Вас X86 MikoPBX, то используйте файл обновления с "x86\_64" в названии. {% endhint %}
2. Проверьте, что архитектура образа совпадает с архитектурой VM. 3. Откройте **Обслуживание** → **Обновление PBX**.

Раздел "Обслуживание" -> "Обновление PBX"

4. Выберите скачанный `.img` и нажмите **Применить обновление**.

Применение обновления

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

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

6. Дождитесь автоматической перезагрузки и повторного запуска сервисов. ## Можно ли обновить облачную VM через ISO Обновление через ISO возможно только тогда, когда облачная платформа одновременно позволяет: * загрузить или подключить пользовательский ISO; * изменить порядок загрузки VM; * открыть интерактивную консоль; * после обновления отключить ISO и снова загрузиться с системного диска. {% hint style="danger" %} Если провайдер не поддерживает ISO, не пытайтесь имитировать этот способ заменой системного диска. Используйте web-обновление либо восстановление из snapshot. {% endhint %} Если все условия выполняются (например как [в Vultr](/mikopbx/setup/cloud/vultr.md)), порядок действий совпадает с обычной виртуальной машиной: 1. Скачайте и подключите ISO-образ нужной версии со страницы [релизов MikoPBX](https://github.com/mikopbx/Core/releases).

Загрузка .iso c GitHub MikoPBX

2. Запустите машину и откройте её консоль. Дождитесь сообщения о загрузке в режиме восстановления — **System booted in recovery mode (Live CD)**.

Загруженная MikoPBX в Recovery mode

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

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

4. Выберите "**Update to version...".** В русской локализации пункт называется "**Обновить до версии...".** {% hint style="danger" %} Не выбирайте пункт **Install**. Он запускает новую установку и предупреждает об удалении данных на выбранном диске. Для обновления с сохранением настроек нужен пункт **Update to version...** {% endhint %}

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

5. После завершения отключите ISO и загрузитесь с системного диска. --- # 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/cloud-virtual-machine.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.