Updating a virtual machine

Updating MikoPBX installed on a virtual machine

We recommend updating sequentially, without skipping releases and versions.

This guide is intended for MikoPBX installed as a full-fledged virtual machine in VMware, VirtualBox, Hyper-V, KVM, Proxmox VE, and other hypervisors.

Two update methods are available for this type of installation:

• through the web interface — the primary and most convenient method;

• from an ISO image — a fallback method if the web interface is unavailable or the system needs to be recovered.

Before updating, be sure to create a backup of the MikoPBX settings. Additionally, it is recommended to create a virtual machine snapshot using the hypervisor's tools.

Preparation

1. Make sure you have access to the web interface and the virtual machine console. Create a backup of the MikoPBX settings and call recordings.

2. Create a virtual machine snapshot. If the hypervisor allows, take it with the virtual machine powered off.

3. Make sure at least 400 MB is free on the system disk.

4. Schedule a maintenance window: during the update, MikoPBX will reboot, and current calls will be dropped.

Do not power off the virtual machine and do not perform a forced reset while the update is being written.

Updating through the web interface

Updating to a version from the list

1. Open the MikoPBX web interface.

2. Go to Maintenance → PBX update.

"PBX update" section

1. In the "Online updates available" table, find the version you need. Review the list of changes and click the update button next to the selected version.

Button to update the station from the web interface

1. Wait for the image to download. Do not close the page until the confirmation dialog appears. Enter the phrase "Yes, I have a backup". Click Update.

Confirmation of backup existence

MikoPBX will prepare the update and reboot the virtual machine automatically.

Updating with a local IMG file

This method is suitable if the required version is not in the list of online updates or the file has already been downloaded in advance.

1. Download the .img file of the required version from the MikoPBX releases page.

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.

Downloading .img for update

1. In the web interface, open Maintenance → PBX update.

"PBX update" section

1. In the file selection field, specify the downloaded .img.

The update form only accepts a .img file. ISO, RAW, VHD, and the LXC archive are not suitable for this method.

Selecting update file

1. Click Apply update.

Button to apply the update

1. Enter the phrase "Yes, I have a backup". Confirm the update and wait for the reboot.

Confirmation of backup existence

Updating from an ISO image

Use this option if the PBX does not boot normally, the web interface is unavailable, or you need to perform the update from Recovery mode.

1. Download the ISO image of the required version from the MikoPBX releases page.

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.

Downloading .iso for update

1. Power off the virtual machine. In the hypervisor settings, connect the ISO to the virtual CD/DVD drive and set booting from the virtual CD/DVD before the system disk.

Example of a mounted .iso file in the UTM hypervisor.

1. Start the virtual machine and open its console.

2. Wait for the message about booting in recovery mode — System booted in recovery mode (Live CD).

MikoPBX in Recovery Mode

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

"Install or recover" section in the MikoPBX console menu

1. Select "Update to version..."

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.

Version update to 2026.3.40

After the operation is complete:

1. Power off the virtual machine if the ISO was not disconnected automatically.

2. Disconnect the ISO from the virtual drive.

3. Restore booting from the system disk as the first boot device.

4. Start the virtual machine.

Successful update of the station to version 2026.3.40.