UCI config migration across OpenWrt releases

Jonas Lochmann openwrt at jonaslochmann.de
Mon Apr 13 11:41:50 PDT 2026


Am Mon, Apr 13, 2026 at 03:35:32PM +0200, schrieb Tanjeff Moos via openwrt-devel:
> * For minor updates (e.g. 24.10.5 → 24.10.6), configurations can usually
>   be kept.

I agree with this.

> * For major updates (e.g. 24.10.x → 25.12.1), recreating the
>   configuration is recommended.

I only once recreated the configuration and this was when the device
was migrated from one switch configuration system to another. I could
have avoided even that by attaching a serial console and editing the
configuration using that after the update (or perfectly creating a
suitable new configuration before updating without applying it).

> However, many of those discussions are quite old, so I am wondering whether
> this guidance is still accurate today.

I think this depends on the target group. For very simple users that do
not read changelogs or release announcements, I would still recommend
that. Otherwise, I see no reason to not keep the configuration.



More information about the openwrt-devel mailing list