Before installing OpenWrt 25.12.6, match the router and plan its recovery

BananaPi, OpenWrt One rear-case photograph, via Software Freedom Conservancy, CC BY-SA 4.0. Original file unchanged. The OpenWrt One is one of the models in the 25.12.6 firmware catalogue. Its rear switch is marked NAND and NOR. The project gallery photograph predates this firmware release. Original gallery · Photo credit record · Licence.

A router can finish restarting and still leave the people who depend on it offline. Before changing its firmware, record the exact model, the version already running and how you would get back into the router if its usual connection disappeared. The OpenWrt 25.12.6 release makes a good case for answering those questions while the network still works.

OpenWrt dates this stable service release to 18 October 2026. Its download index still listed 25.12.6 as the current stable version when PING checked on 8 November. The project lists security fixes alongside changes that affect certain devices and configurations. Download index · Maintainer announcement and known issues.

Start with the name on the router

Write down the model and hardware revision from the unit or its existing management screen, then look for that exact match in the Firmware Selector. The selector offers stable and nightly snapshot builds. If you are following the 25.12.6 release notes, use the 25.12.6 listing to make the comparison. Read the device instructions before deciding which file, if any, applies. Firmware Selector.

The OpenWrt One pictured here has its own openwrt_one profile under MediaTek Filogic in the 25.12.6 catalogue. That profile lists a sysupgrade image alongside separate factory and boot files. Each serves a different purpose. A familiar product name or the presence of a firmware file tells you little about the correct procedure for a router that is still running its manufacturer’s software. OpenWrt One build profile.

Check where the upgrade starts

The maintainers expect the move from 24.10 to 25.12 to carry most settings across on most devices. The same release notes say direct Sysupgrade from 23.05 or earlier has no official support. For upgrades within the 25.12 series, the maintainers list Attended Sysupgrade as a route that can preserve installed packages. Check the instructions for your model and make a separate record of settings you rely on.

Look at the BananaPi BPI-R4, a different model from the OpenWrt One. The release announcement lists renamed network interfaces and tells BPI-R4 owners to upgrade without carrying over the old configuration. For that device, the maintenance plan needs time to rebuild the settings that make its ports useful. Release notes.

Keep the recovery instructions somewhere you can reach

Save the model’s instructions and a current configuration backup somewhere you can reach without this router. Record which port and cable you need for local access, which internet connection the router serves and which settings you would rebuild by hand. The OpenWrt One has a model-specific switch for its two flash types. Look up the equivalent recovery method for your own device. OpenWrt One project page.

For a shared studio in Lagos or a small office in London, the same planning question applies. If this box goes offline, who can reach it, and how will everyone else get online? Put the work in a quiet window. Keep a spare connection where practical, especially if a call, payment terminal or class relies on the router. Tell the people using it when work will begin and how they can report a service that has not returned.

When the router returns, check that you can reach its management page, that the version is the one you intended, and that the wired and wireless clients you rely on can reach their services. If local access works but internet access does not, keep those two observations separate when asking for help. For the larger network question, read PING’s African last-mile explainer.