Updating a physical server

Updating MikoPBX installed on a dedicated physical computer

We recommend updating sequentially, without skipping releases and versions.

This guide is intended for a dedicated computer or server running MikoPBX.

The primary method is updating through the web interface. If the PBX does not boot normally or the web interface is unavailable, use an ISO image written to a separate USB drive.

Before updating, be sure to create a backup of the settings and store it on another device. Also save a copy of the call recordings.

Preparation

1. Make sure you have physical access to the server or a working console. Create a backup of the MikoPBX settings and call recordings.

2. Make sure at least 400 MB is free on the Storage.

3. End active calls and schedule a maintenance window for the telephony system.

Updating through the web interface

Online update

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

"PBX update" section

1. Select the desired version in the list. Review the list of changes and start the update process.

A button to update the station from the web interface

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

Confirmation of backup existence

Updating with a local IMG file

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.

Donwloading .img for update

1. Open Maintenance → PBX update.

"PBX update" section

1. Select the downloaded .img file.

Selecting update file

1. Click Apply update.

Button to apply the update

1. Enter the phrase Yes, I have a backup and confirm the operation.

Confirmation of backup existence

Wait for the PBX to reboot automatically after the update.

Updating from an ISO on a USB drive

This method is suitable for restoring and updating the PBX from the local console.

Creating bootable media

1. Download the ISO 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. Connect a separate USB drive with a capacity of at least 1 GB.

2. Write the ISO in disk image mode using Rufus, balenaEtcher, or dd. Instructions for writing an ISO image can be found here.

Writing the ISO will erase all data on the selected USB drive. Double-check the selected device.

Running the update

1. Connect the prepared USB drive to the server. In the BIOS/UEFI or Boot Menu, select booting from USB.

2. Wait for MikoPBX to start in Recovery mode.

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 "2) Update to version..."

The Install option is intended for a new installation and erases the data on the selected device. To update while keeping the settings, only choose "Update to version..."

Version update to 2026.3.40

1. Wait for the writing to finish and the reboot. Remove the USB drive or restore the system disk as the first boot device.

Successful update of the station to version 2026.3.40.