> 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/virtual-machine.md).

# Обновление виртуальной машины

Обновление MikoPBX, установленной на виртуальную машину

{% hint style="warning" %}
Рекомендуется производить обновления последовательно, «не перепрыгивая» через релизы и версии.
{% endhint %}

Эта инструкция подходит для MikoPBX, установленной как полноценная виртуальная машина в VMware, VirtualBox, Hyper-V, KVM, Proxmox VE и других гипервизорах.

Для такой установки доступны два способа обновления:

* **через web-интерфейс** — основной и наиболее удобный способ;
* **с ISO-образа** — резервный способ, если web-интерфейс недоступен или требуется восстановление системы.

{% hint style="danger" %}
Перед обновлением обязательно создайте резервную копию настроек MikoPBX. Дополнительно рекомендуется создать snapshot виртуальной машины средствами гипервизора.
{% endhint %}

## Подготовка

1. Убедитесь, что у вас есть доступ к web-интерфейсу и консоли виртуальной машины. Создайте резервную копию настроек MikoPBX и записей разговоров.
2. Создайте snapshot виртуальной машины. Если гипервизор позволяет, снимайте его при выключенной виртуальной машине.
3. Убедитесь, что на системном диске свободно не менее **400 МБ**.
4. Запланируйте техническое окно: во время обновления MikoPBX перезагрузится, а текущие вызовы будут завершены.

{% hint style="warning" %}
Не выключайте виртуальную машину и не выполняйте принудительный сброс во время записи обновления.
{% endhint %}

## Обновление через web-интерфейс

### Обновление до версии из списка

1. Откройте web-интерфейс MikoPBX.
2. Перейдите в раздел **Обслуживание** → **Обновление PBX**.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2F9YwZjDFGY4K3A0H764II%2FPBXUpdate_Section.png?alt=media&amp;token=eeb8d514-d3d8-41fd-86cf-f14db1373604" alt=""><figcaption><p>Раздел "Обновление PBX"</p></figcaption></figure>

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FBSKAecHVkBundQsxpM8L%2FupdatePBXFromWeb.png?alt=media&amp;token=a7a68ff4-7db5-4c52-9e09-ed1e8eeec540" alt=""><figcaption><p>Кнопка для обновления станции из веб интерфейса</p></figcaption></figure>

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FEBE08jjdi1U1baF13E84%2FMikoPBX_UpdateConfirmation.png?alt=media&amp;token=2df1c08a-7f03-401b-a5eb-7bef60e12845" alt=""><figcaption><p>Подтверждение наличия резервной копии</p></figcaption></figure>

MikoPBX подготовит обновление и автоматически перезагрузит виртуальную машину.

### Обновление локальным IMG-файлом

Этот способ подходит, если нужной версии нет в списке онлайн-обновлений или файл уже скачан заранее.

1. Скачайте файл нужной версии с расширением `.img` со страницы [релизов MikoPBX](https://github.com/mikopbx/Core/releases).

{% hint style="info" %}
Обратите внимание на архитектуру Вашей MikoPBX: в случае если у Вас ARM MikoPBX, то используйте файл обновления с "arm64" в названии. Если у Вас X86 MikoPBX, то используйте файл обновления с "x86\_64" в названии.
{% endhint %}

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2F9OBedMxBEzuEsx9GrT8X%2FMikoPBXGithubReleases-IMG.png?alt=media&amp;token=4a2f96f3-f2de-4875-8896-4c9c033e53da" alt=""><figcaption><p>Загрузка .img для обновления</p></figcaption></figure>

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2F9YwZjDFGY4K3A0H764II%2FPBXUpdate_Section.png?alt=media&amp;token=eeb8d514-d3d8-41fd-86cf-f14db1373604" alt=""><figcaption><p>Раздел "Обновление PBX"</p></figcaption></figure>

3. В поле выбора файла укажите скачанный `.img`.

{% hint style="info" %}
Форма обновления принимает именно файл `.img`. ISO, RAW, VHD и архив LXC для этого способа не подходят.
{% endhint %}

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2F5xK9qktUdJoGSyye2zCA%2FMikoPBXUpdate_ChooseIMG.png?alt=media&amp;token=397e3a16-8260-4a4d-928d-bc01e7564b54" alt=""><figcaption><p>Поле для выбора файла обновления</p></figcaption></figure>

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FEE4Km9POTzx9DThTp1fU%2FMikoPBX_ApplyUdate.png?alt=media&amp;token=afac407f-e50f-4647-ae6d-da3b4463a264" alt=""><figcaption><p>Кнопка "Применить обновление"</p></figcaption></figure>

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FEBE08jjdi1U1baF13E84%2FMikoPBX_UpdateConfirmation.png?alt=media&amp;token=2df1c08a-7f03-401b-a5eb-7bef60e12845" alt=""><figcaption><p>Подтверждение наличия резервной копии</p></figcaption></figure>

## Обновление с ISO-образа

Используйте этот вариант, если станция не загружается штатно, web-интерфейс недоступен либо требуется выполнить обновление из Recovery mode.

1. Скачайте ISO-образ нужной версии со страницы [релизов MikoPBX](https://github.com/mikopbx/Core/releases).

{% hint style="info" %}
Обратите внимание на архитектуру Вашей MikoPBX: в случае если у Вас ARM MikoPBX, то используйте файл обновления с "arm64" в названии. Если у Вас X86 MikoPBX, то используйте файл обновления с "x86\_64" в названии.
{% endhint %}

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2F0bOLrZ4kJsdUQ16KSsiv%2FMikoPBXGithubReleases-ISO.png?alt=media&amp;token=2b552342-0d0d-4d58-a16e-969b37cedea7" alt=""><figcaption><p>Загрузка .iso c GitHub MikoPBX</p></figcaption></figure>

2. Выключите виртуальную машину. В настройках гипервизора подключите ISO к виртуальному CD/DVD-приводу и установите загрузку с виртуального CD/DVD раньше системного диска.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FcJb8dC8LP5Pn3FSb4bvn%2FattachISOToVMUTM.png?alt=media&amp;token=643642bc-d51e-4197-b90f-f5c615f3958f" alt=""><figcaption><p>Пример подключенного .iso в гипервизоре UTM</p></figcaption></figure>

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2F9goyIEL7HQkqIKqgL8v4%2FMikoPBX-RecoveryMode3.40.png?alt=media&amp;token=eedf5b57-5d1d-4a4c-8469-5d3e75cbf37c" alt=""><figcaption><p>Загруженная MikoPBX в Recovery mode</p></figcaption></figure>

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FoI5VidWpQ60ZLbUqgjyx%2FMikoPBX-3.40-InstallOrRecover.png?alt=media&amp;token=53078af2-7145-47d6-904f-1e3224e61e81" alt=""><figcaption><p>Раздел "Install or recover" в консольном меню MikoPBX</p></figcaption></figure>

6. Выберите "**Update to version...".** В русской локализации пункт называется "**Обновить до версии...".**

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

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FmQFhkKNEsghZfpZ2olUm%2FMikoPBXConsole-UpdateTo3.40.png?alt=media&amp;token=3e665b43-df99-433f-b967-a3b0f0522d4c" alt=""><figcaption><p>Обновление версии на 2026.3.40</p></figcaption></figure>

После завершения операции:

1. Выключите виртуальную машину, если ISO не был отключён автоматически.
2. Отключите ISO от виртуального привода.
3. Верните загрузку с системного диска на первое место.
4. Запустите виртуальную машину.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2F8aInG7OkHP9j6jRlPPOZ%2FUpdatedMikoPBX2026.3.40.png?alt=media&amp;token=fb5b2222-b2b3-4bc4-b428-37443c650e44" alt=""><figcaption><p>Обновленная MikoPBX на версию 2026.3.40</p></figcaption></figure>


---

# 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/virtual-machine.md?ask=<question>&goal=<endgoal>
```

`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.