Skip to main content

How to Fix OneKey Pro Firmware Upgrade Error

When upgrading the firmware on your OneKey Pro, you may encounter the following error message:

Error Message:

Request failed > Failure_ProcessError, Update file header invalid! : 800

Please follow the steps below to resolve this issue:


Step 1: Download the Latest Bootloader File

Download the latest version of the bootloader file:
👉 Download bootloader file


Step 2: Open the Repair Tool Page

Open the following page in Chrome browser:
👉 Repair tool - emmcFileWrite

  • Connect your OneKey Pro hardware wallet.

  • Select WebUSB as the connection method (see example image below).


Step 3: Write the Bootloader File

  1. Locate the “emmcFileWrite” option on the page and open it.

  2. Choose the bootloader file you downloaded earlier.

  3. Click the “Execute” button and wait until the process is completed.

Once successful, the bootloader repair is finished.


Step 4: Upgrade the Firmware Again

  1. Open the firmware upgrade page in Chrome browser:
    👉 OneKey Pro Firmware Upgrade

  2. Select the latest firmware version on the page and follow the instructions to complete the upgrade.

  3. After the upgrade, your OneKey Pro should work normally.


如在操作过程中遇到任何问题,您可以联系在线客服:https://onekey.so?openMessenger,或发送邮件至 [email protected] 获取帮助。


On Ubuntu 24.04 or later, if OneKey Wallet fails to launch with an error about a missing libgbm.so.1 or fails to open properly, it is usually related to changes in system security policies. For example, AppArmor restrictions may prevent Electron-based AppImage files from initializing the sandbox environment correctly. If you are using the Snap version, its isolation mechanism may also affect the application's ability to read underlying system graphics libraries.

This compatibility issue has been reported to the development team for a fix. A temporary workaround is to use the AppImage version and add the --no-sandbox parameter when launching it:

./OneKey-Wallet-*.AppImage --no-sandbox

Open the terminal in the directory where the AppImage file is located and execute the command above to bypass the relevant permission restrictions and launch the application.


On Ubuntu 24.04 or later versions, if OneKey Wallet fails to launch with a libgbm.so.1 missing error or does not open correctly, it is usually related to changes in system security policies. For example, AppArmor restrictions may prevent Electron-based AppImage files from properly initializing their sandbox environment. If you are using the Snap version, its isolation mechanism may also prevent the application from accessing low-level system graphics libraries.

This compatibility issue has been reported to our development team for a fix. A temporary workaround is to use the AppImage version and include the --no-sandbox parameter when launching it:

./OneKey-Wallet-*.AppImage --no-sandbox

Open a terminal in the directory where the AppImage file is located and execute the above command to bypass the relevant permission restrictions and launch the application.

Did this answer your question?