Firmware update on Turris devices⚓︎

Warning

This feature is currently experimental and intended for testing purposes.

While Turris OS updates automatically, the U-Boot bootloader, rescue system, and the MCU firmware do not. These low-level components have received significant improvements since the initial hardware release. This guide explains how to update them manually to resolve issues caused by outdated firmware.

Danger

Older revisions of Turris Omnia, such as the CZ11NIC13, are susceptible to RAM training issues with newer U-Boot versions. Updating the U-Boot environment on these devices may result in a boot loop.

Firmware update⚓︎

Warning

Ensure the device remains powered on throughout the entire update process. Recovery from a failed firmware update is difficult.

Via reForis⚓︎

Starting with Turris OS 6.5, you can update the device firmware directly through the reForis interface.

To enable automatic firmware updates in reForis:

Navigate to Package Management → Packages.

And check the relevant firmware update packages.

Via CLI⚓︎

Install the turris-nor-update package.

opkg update && opkg install turris-nor-update

Run the utility.

nor-update

Note

You may see a verification failure in the output:

Verifying /dev/mtd0 against secure-firmware.bin
1705eb30f3e7795d0805e97134515d91 - /dev/mtd0
e12a263c63bd9860cff844763e81e56b - secure-firmware.bin
Failed

A Failed status indicates that your current U-Boot or rescue system is outdated and requires updating. This is expected behavior.

Reboot the device to complete the firmware update.

Important

The update may disable the LEDs. To restore them, press the front LED button. If this fails or you require custom behavior, configure the LEDs via System → LED Configuration in LuCI.