uci
OpenWrt unified configuration interface
TLDR
SYNOPSIS
uci COMMAND [ARGUMENTS...]
DESCRIPTION
uci (Unified Configuration Interface) manages OpenWrt configuration files. It provides a standardized way to read and modify the UCI configuration format used throughout OpenWrt.
Configuration files are stored in /etc/config/ and are organized into files, sections, and options. Changes are staged in a temporary location and must be committed to take effect. The revert command discards uncommitted changes.
COMMANDS
get CONFIG.SECTION.OPTION
Fetch a valueshow [CONFIG]
List all options and valuesset CONFIG.SECTION.OPTION=VALUE
Set a configuration valueadd CONFIG SECTION
Add a new anonymous sectiondelete CONFIG.SECTION[.OPTION]
Delete section or optionrename CONFIG.SECTION[.OPTION]=NAME
Rename a section or optionadd_list CONFIG.SECTION.OPTION=VALUE
Add a value to a list optiondel_list CONFIG.SECTION.OPTION=VALUE
Remove a value from a list optioncommit [CONFIG]
Write changes to configuration filerevert CONFIG
Discard uncommitted changeschanges [CONFIG]
Display pending uncommitted changesexport [CONFIG]
Export configuration in machine-readable format
CAVEATS
OpenWrt specific. Changes require commit to apply. Some services need restart after configuration changes. Invalid configuration can break network access.
HISTORY
UCI was developed for OpenWrt to provide a consistent configuration interface across all system services, simplifying administration of embedded routers and devices.
