owut - OpenWrt Upgrade Tool

owut is command line tool that upgrades your router's firmware. It creates custom images of OpenWrt using the sysupgrade server and installs them, retaining all of your currently installed packages and configuration.

Follow along or participate in the owut package discussion on the OpenWrt forum.

Installation

Warning

owut depends on the ucode-mod-uclient package, which is only available on versions 24.10 and later, including main snapshots. For OpenWrt 23.05 and earlier, use the auc package.

owut is a standard OpenWrt package, making installation quite simple.

# If using opkg package manager:
opkg update && opkg install owut

# If using apk package manager:
apk --update-cache add owut

Or, for the hardy or adventurous, install from source:

opkg update
opkg install attendedsysupgrade-common rpcd-mod-file ucode ucode-mod-fs \
             ucode-mod-ubus ucode-mod-uci ucode-mod-uclient ucode-mod-uloop

[ ! -d /usr/share/ucode/utils/ ] && mkdir -p /usr/share/ucode/utils/ 
wget -O /usr/share/ucode/utils/argparse.uc https://raw.githubusercontent.com/efahl/owut/main/files/argparse.uc
wget -O /usr/bin/owut https://raw.githubusercontent.com/efahl/owut/main/files/owut
hash="$(wget -q -O - https://api.github.com/repos/efahl/owut/commits/main | jsonfilter -e '$.sha' | cut -c-8)"
sed -i -e "s/%%VERSION%%/source-$hash/" /usr/bin/owut

chmod +x /usr/bin/owut

Documentation

Short documentation is available on your device, use owut --help

Full documentation is available in the OpenWrt wiki at owut: OpenWrt Upgrade Tool

Packaging in https://github.com/openwrt/packages/blob/master/utils/owut/Makefile

License

SPDX-License-Identifier: GPL-2.0-only