UCI config migration across OpenWrt releases

Tanjeff Moos Tanjeff.Moos at westermo.com
Mon Apr 13 06:35:32 PDT 2026


Hi all,

when UCI configuration options change between releases, is there an 
established convention to provide migration support? In other words: is 
it generally safe for users to keep their existing configuration files 
when upgrading OpenWrt?

I could not find definitive documentation on this. Based on forum 
discussions, the rough rule of thumb seems to be:

* For minor updates (e.g. 24.10.5 → 24.10.6), configurations can usually
   be kept.
* For major updates (e.g. 24.10.x → 25.12.1), recreating the
   configuration is recommended.

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

Kind regards, Tanjeff



More information about the openwrt-devel mailing list