> 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/bare-metal.md). # Updating a physical server Updating MikoPBX installed on a dedicated physical computer {% hint style="warning" %} We recommend updating sequentially, without skipping releases and versions. {% endhint %} 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. {% hint style="danger" %} 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. {% endhint %} ## 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"**.

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

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

### Updating with a local IMG file 1. Download the `.img` file 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 %}

2. Open **Maintenance** → **PBX update**.

3. Select the downloaded `.img` file.

4. Click **Apply update**.

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

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](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 %}

2. Connect a separate USB drive with a capacity of at least 1 GB. 3. Write the ISO in disk image mode using Rufus, balenaEtcher, or `dd`. Instructions for writing an ISO image can be found [here](/mikopbx/english/setup/bare-metal/live-usb.md#writing-the-image-to-a-usb-drive). {% hint style="danger" %} Writing the ISO will erase all data on the selected USB drive. Double-check the selected device. {% endhint %} ### 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.

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

"Install or recover" section in the MikoPBX console menu

4. Select **"2) Update to version..."** {% hint style="info" %} 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..."** {% endhint %}

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

--- # 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/bare-metal.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.