> 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/english/manual/maintenance/update/cloud-virtual-machine.md).

# Updating a cloud virtual machine

Updating MikoPBX deployed as a virtual machine in the cloud

{% hint style="warning" %}
We recommend updating sequentially, without skipping releases and versions.
{% endhint %}

This guide is intended for MikoPBX running as a full-fledged cloud virtual machine: from a Marketplace or from an imported RAW, VHD, or other disk image.

{% hint style="info" %}
The built-in update mechanism is designed for a standard disk installation of MikoPBX with a boot partition, the `/cf` configuration partition, and attached Storage. It is not intended for Docker and LXC.
{% endhint %}

The primary method for updating a cloud PBX is through the web interface using an `.img` image. The ability to boot from an ISO depends on the particular cloud provider and is not universal.

{% hint style="danger" %}
Before updating, create two independent recovery points: a backup of the MikoPBX settings and a snapshot of the system disk or the entire virtual machine in the cloud provider's control panel.
{% endhint %}

## Before you start

1. Make sure you have access to the cloud management panel and the MikoPBX web interface. Save a backup of the MikoPBX settings and call recordings outside the virtual machine being updated.
2. Create a snapshot of the system disk. If there is a separate disk with recordings, create a snapshot for it as well or use storage backup.
3. Write down the current external and internal IP addresses, Security Group rules, attached disks, and network settings.
4. Make sure at least **400 MB** is free on the system disk with MikoPBX.
5. Schedule a maintenance window: active calls will be dropped.

## Online update

1. Log in to the MikoPBX web interface.
2. Open **"Maintenance"** → **"PBX update"**.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FOXpfdCkNWthvFkD1gVvK%2FPBXUpdate_Section.png?alt=media&amp;token=c7471c94-6394-40e0-a940-3f929ddcf947" alt=""><figcaption><p>"PBX update" section</p></figcaption></figure>

3. Find the version you need in the **"Online updates available"** table. Review the list of changes and start the download.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FBKfhpNNDSJpnEA8QmOgK%2FupdatePBXFromWeb.png?alt=media&amp;token=4d637ce8-2d6b-4ad5-bcb6-452eb6299b4f" alt=""><figcaption><p>Button to update the station from the web interface</p></figcaption></figure>

4. Once the download is complete, enter the phrase **"Yes, I have a backup"**. Click **Update**.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FbLSCLYKJQ0atPXbvrpLn%2FMikoPBX_UpdateConfirmation.png?alt=media&amp;token=014c2344-bf82-4c72-8e72-b318b01f8e4b" alt=""><figcaption><p>Confirmation of backup existence</p></figcaption></figure>

5. Do not perform Restart or Stop from the cloud panel: MikoPBX will prepare the update and reboot on its own. During the reboot, the connection to the web interface will be interrupted. It is safer to monitor the process via the cloud provider's serial console or web console.

## Updating with a downloaded IMG file

Use a local file if the version is not in the list or the cloud VM does not have direct access to the update server.

1. Download the `.img` of the required version from the [MikoPBX releases](https://github.com/mikopbx/Core/releases) page.

{% hint style="info" %}
Pay attention to the architecture of your MikoPBX: if you have an ARM MikoPBX, use the update file with "arm64" in its name. If you have an x86 MikoPBX, use the update file with "x86\_64" in its name.
{% endhint %}

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2Fb8KnA6UNRMfqzJ0KIb8h%2FMikoPBXGithubReleases-IMG.png?alt=media&amp;token=b1c2c6c2-3167-4d0f-9d6b-91110055e3b5" alt=""><figcaption><p>Downloading .img for update</p></figcaption></figure>

2. Verify that the image architecture matches the VM architecture.
3. Open **Maintenance** → **PBX update**.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FOXpfdCkNWthvFkD1gVvK%2FPBXUpdate_Section.png?alt=media&amp;token=c7471c94-6394-40e0-a940-3f929ddcf947" alt=""><figcaption><p>"PBX update" section</p></figcaption></figure>

4. Select the downloaded `.img` and click **Apply update**.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FzaW9tI3kN7zaNA7bco4u%2FMikoPBXUpdate_ChooseIMG.png?alt=media&amp;token=e76c27b5-0cad-4487-b7b7-e45cac68e16d" alt=""><figcaption><p>Selecting and applying update file</p></figcaption></figure>

5. Enter the phrase **"Yes, I have a backup"** and confirm the operation.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FbLSCLYKJQ0atPXbvrpLn%2FMikoPBX_UpdateConfirmation.png?alt=media&amp;token=014c2344-bf82-4c72-8e72-b318b01f8e4b" alt=""><figcaption><p>Confirmation of backup existence</p></figcaption></figure>

6. Wait for the automatic reboot and the services to start again.

## Is it possible to update a cloud VM via ISO

Updating via ISO is possible only when the cloud platform simultaneously allows you to:

* upload or attach a custom ISO;
* change the VM boot order;
* open an interactive console;
* after the update, disconnect the ISO and boot from the system disk again.

{% hint style="danger" %}
If the provider does not support ISO, do not try to imitate this method by replacing the system disk. Use the web update or restore from a snapshot.
{% endhint %}

If all the conditions are met (for example, as [with Vultr](/mikopbx/english/setup/cloud/vultr.md)), the procedure is the same as for a regular virtual machine:

1. Download and attach the ISO image of the required version from the [MikoPBX releases](https://github.com/mikopbx/Core/releases) page.

{% hint style="info" %}
Pay attention to the architecture of your MikoPBX: if you have an ARM MikoPBX, use the update file with "arm64" in its name. If you have an x86 MikoPBX, use the update file with "x86\_64" in its name.
{% endhint %}

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FADgXtWR25BNDMvktouDc%2FMikoPBXGithubReleases-ISO.png?alt=media&amp;token=0445bad2-dee6-433b-beb1-754ba4fed041" alt=""><figcaption><p>Downloading .iso for update</p></figcaption></figure>

2. Start the machine and open its console. Wait for the message about booting in recovery mode - **System booted in recovery mode (Live CD)**.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FNVvXR9NQtwBjjLqHkxje%2FMikoPBX-RecoveryMode3.40.png?alt=media&amp;token=078483ef-a409-46e5-a647-06b60c927aef" alt=""><figcaption><p>MikoPBX in Recovery Mode</p></figcaption></figure>

3. Press any key to open the console menu. Then open **"\[4] Install or recover"**.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FyyphjPoRPm1vVDYh07Sl%2FMikoPBX-3.40-InstallOrRecover.png?alt=media&amp;token=c68bfc24-d6f0-4c06-a4eb-8d4e94484402" alt=""><figcaption><p>"Install or recover" section in the MikoPBX console menu</p></figcaption></figure>

4. Select **"Update to version..."**

{% hint style="danger" %}
Do not select the **Install** option. It starts a new installation and warns that data on the selected disk will be erased. To update while keeping the settings, use the **Update to version ...** option.
{% endhint %}

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FBjoFf2CsEMpS5HeFxoCs%2FMikoPBXConsole-UpdateTo3.40.png?alt=media&amp;token=995274db-4fd5-435f-8b3e-87038834bd10" alt=""><figcaption><p>Version update to 2026.3.40</p></figcaption></figure>

5. When finished, disconnect the ISO and boot from the system disk.


---

# 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/english/manual/maintenance/update/cloud-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.