Skip to content

Offline Upgrade

You can upgrade firmware even without internet access — download the firmware package on a computer, put it on a TF card, insert it into the device, and upload for upgrade.

Go to Settings → Upgrade.

Upgrade interface

Download Firmware Package

Download the OTA image file (.tar format) from either source on your computer:

Source URL Best for
GitHub github.com/chutuotek/flexkvm/releases International users
Gitee gitee.com/chutuotek/flexkvm/releases Users in China, faster

On the releases page, find the target version and download the .tar firmware package (e.g., flexkvm-v1.0.0.tar). Copy it to a TF card, then insert the TF card into FlexKVM.

Upload Image

Go to Settings → Upgrade → click Upload → select the firmware package on the TF card.

Upload progress

Verify: After upload, verification passes and the upgrade card becomes active (no longer grayed out).

Upgrade

Click Upgrade - a dialog shows the image SHA-256 checksum. Confirm it's correct, then click Upgrade - enter password (with 2FA enabled, also enter verification code):

Upgrade package verification

User verification

After verification, upgrade begins:

Upgrade progress

Verify: During upgrade, the OLED shows an upgrade icon and 🔴 Warning LED fast-blinks. When complete, the device auto-reboots and OLED shows the IP again.

Upgrade success:

Upgrade success

OTA only upgrades to a higher version — downgrades and same-version overwrites are not supported. ⚠️ Keep power stable during upgrade; power loss may cause upgrade failure.


Back to User Guide