Description
OpenWRT a intégré le système de mise à niveau ASU pour Attented SysUpgrade, depuis la version 24.10. À ce moment-là, ce système était secondaire pour faire les mises à niveau d’OpenWRT.
Depuis la version 25.12.0, c’est LE système à utiliser par défaut, et pleinement
intégré à LuCI. Le pendant CLI se nommme owut (OpenWRT Upgrade Tool).
ASU permet :
- la mise à niveau (upgrade) des nouvelles versions du micrologiciel d’OpenWRT
- de reconstruire automatiquement les images des micrologiciels avec tous les paquets installés.
- préserve la configuration système durant les mises à niveaux
- permet l’intégration des paquets supplémentaires, installés par l’utilisateur, directement dans le système de fichiers SquashFS, tout en préservant la configuration relative.
Le but est de simplifier de manière drastique les mises à niveaux : en quelques clics de souris, une image du micrologiciel personnalisé est construite et installée, sans aucune intervention manuelle !
Installation
Le paquet luci-app-attendedsysupgrade est normalement installé,
depuis 24.10.0
Dans LuCI, un menu apparaît : “System” > “Attented Sysupgrade” !
Menu System
Backup
Le premier réflexe à avoir est de faire une sauvegarde du système actuel !
⇒ Menu “System” > “Backup / Flash firmware”, puis section Backup
- cliquez sur le bouton [ Generate archive ].
Une fois générée, il vous sera proposer de la sauvegarder dans votre système de fichier, sur votre ordinateur utilisé.
Ce réflexe est primordial et à répéter à chaque processus de mise à niveau !
Attented Sysupgrade
⇒ Menu “System” > “Attented Sysupgrade”.
- Cliquez sur le bouton [ Search for firmware upgrade ]
Attented Sysupgrade : Recherche d’une nouvelle image disponible - une fenêtre contextuelle apparaît pour sélectionner la version du micrologiciel,
puis cliquez sur le bouton [ Request firmware image ].
Attented Sysupgrade : Sélection d’une nouvelle image disponible - Une nouvelle fenêtre avertissant du succès de la création de l’image du micrologiciel
doit apparaître, si c’est le cas :
Attented Sysupgrade : Succès de la création de l’image - Cette fenêtre affiche :
- le numéro de version,
- la somme de contrôle SHA256 relative,
- permet de télécharger le micrologiciel créé - faites-le.
Vérifiez que la case à cocher devant l’option pour garder la configuration actuelle soit activée.
Puis cliquez sur le bouton [ Install firmware image ] !
- Cette fenêtre affiche :
- La fenêtre contextuelle d’installation avertit de la phase d’installation ;
que le système va redémarrer dans quelques instants et d’attendre l’écran
de connexion :
Attented Sysupgrade : Installation de l’image créée
Voilà !
OpenWRT Upgrade Tool
owut est l’outil en ligne de commande officiel.
Installation
Si votre version de firmware est relative à 24.10, il faut d’abord l’installer :
#: opkg update
#: opkg install owut
Concernant les versions 25.12.x et supérieures, il faut utiliser le nouvel outil :
#: apk -U upgrade owut
Configuration
Le fichier de configuration : /etc/config/attendedsysupgrade
Backup
Avant d’utiliser owut, faites impérativement un backup de votre micrologiciel
actuel et sauvegardez-le :
# sysupgrade -l
# sysupgrade -b /tmp/backup-${HOSTNAME}-$(date +%F).tar.gz
Récupèrer cette sauvegarde depuis votre ordinateur :
$: scp -O root@openwrt:/tmp/backup*.tar.gz $(pwd)
- ‘openwrt’ est l’adresse IP de votre routeur, ou son nom de machine…
- l’utilisation de l’option
-Oest nécessaire… si votre client SSH est ≥ 9.0.
Utilisation
Les différentes options sont visibles, par l’usage de l’option -h ou --help.
La mise à niveau du micrologiciel OpenWRT est très simple, et se fait par le biais
de l’option upgrade, tel que :
# owut upgrade
Pour exemple, voici le retour sur un OpenWRT One :
# v="25.12"
# owut check --verbose --version-to ${v}
(… affichage du résultat …)
# owut upgrade --verbose --version-to ${v}
owut - OpenWrt Upgrade Tool 2026.01.13~2526d84b-r1 (/usr/bin/owut)
ASU-Server https://sysupgrade.openwrt.org
Upstream https://downloads.openwrt.org
Target mediatek/filogic
Profile openwrt_one
Package-arch aarch64_cortex-a53
Root-FS-type squashfs
Sys-type sysupgrade
Version-from 24.10.5 r29087-d9c5716d1d (kernel 6.6.119)
Version-to 25.12.0 r32713-f919e7899d (kernel 6.12.71)
Build-commit https://git.openwrt.org/?p=openwrt/openwrt.git;a=shortlog;h=f919e7899d
Build-FS-type squashfs
Build-at 2026-03-03T00:14:15Z (~7 days ago)
Image-prefix openwrt-25.12.0-mediatek-filogic-openwrt_one
Image-URL https://downloads.openwrt.org/releases/25.12.0/targets/mediatek/filogic
Image-file openwrt-25.12.0-mediatek-filogic-openwrt_one-squashfs-sysupgrade.itb
Installed 201 packages
Top-level 62 packages
Default 37 packages
User-installed 31 packages (top-level only)
Package version changes:
(… affichage des changements de versions des paquets …)
23 packages were downgraded
168 packages are out-of-date
Automatic package replacements/removals:
Package Replaced-by
opkg apk-mbedtls
Details at https://sysupgrade.openwrt.org/json/v1/overview.json
Default package analysis:
Default Provided-by
nftables nftables-json
There are currently package build failures for 25.12.0 aarch64_cortex-a53:
Feed: packages
domoticz Mon Mar 9 12:04:30 2026 - not installed
pigeonhole Mon Mar 9 12:17:05 2026 - not installed
pillow Mon Mar 9 11:48:09 2026 - not installed
python-flask-httpauth Mon Mar 9 12:05:16 2026 - not installed
python-frozenlist Mon Mar 9 11:48:24 2026 - not installed
python-gevent Mon Mar 9 12:01:06 2026 - not installed
python-gmpy2 Mon Mar 9 11:50:04 2026 - not installed
python-multidict Mon Mar 9 11:48:49 2026 - not installed
python-psycopg2 Mon Mar 9 11:50:41 2026 - not installed
python-pyodbc Mon Mar 9 12:01:55 2026 - not installed
python-pyopenssl Mon Mar 9 12:10:32 2026 - not installed
python-ubus Mon Mar 9 11:51:16 2026 - not installed
python-yarl Mon Mar 9 12:00:15 2026 - not installed
Feed: telephony
asterisk-chan-sccp Mon Mar 9 12:39:50 2026 - not installed
Feed: video
assimp Mon Mar 9 10:20:03 2026 - not installed
glslang Mon Mar 9 10:20:11 2026 - not installed
qt5base Mon Mar 9 12:41:00 2026 - not installed
qt5quick Mon Mar 9 12:41:00 2026 - not installed
qt5quick-controls Mon Mar 9 12:41:08 2026 - not installed
qt5script Mon Mar 9 12:40:59 2026 - not installed
qt5svg Mon Mar 9 12:41:02 2026 - not installed
qt5translations Mon Mar 9 13:08:07 2026 - not installed
qt5virtualkeyboard Mon Mar 9 13:08:07 2026 - not installed
vkmark Mon Mar 9 12:36:00 2026 - not installed
24 package build failures don't affect this device, details at
https://downloads.openwrt.org/releases/faillogs-25.12/aarch64_cortex-a53/
Request:
Version 25.12.0 r32713-f919e7899d (kernel 6.12.71)
Request hash:
95b55e4174acfe696ed329815c3e81ac135635039fa36dda5e3a454cff4d63b0
--
Status: queued - 0 ahead of you
Progress: 0s total = 0s in queue + 0s in build
--
Status: init
Progress: 1s total = 0s in queue + 1s in build
--
Status: container_setup
Progress: 5s total = 0s in queue + 5s in build
--
Status: validate_manifest
Progress: 20s total = 0s in queue + 20s in build
--
Status: building_image
Progress: 45s total = 0s in queue + 45s in build
--
Status: done
Progress: 47s total = 0s in queue + 47s in build
Build succeeded in 47s total = 0s in queue + 47s to build:
version_number = 25.12.0
version_code = r32713-f919e7899d (requested r32713-f919e7899d)
kernel_version = 6.12.71
rootfs_size_mb = default
init-script = no-init-script
Image source: https://sysupgrade.openwrt.org/store/95b55e4174acfe696ed329815c3e81ac135635039fa36dda5e3a454cff4d63b0/openwrt-25.12.0-8c74194a8530-mediatek-filogic-openwrt_one-squashfs-sysupgrade.itb
Image saved : /tmp/firmware.bin
Manifest : /tmp/firmware-manifest.json
Verifying : /tmp/firmware.bin (14418186 bytes) against /tmp/firmware.sha256sums
Saved sha256 matches
(null)
Checks complete, image is valid.
Installing /tmp/firmware.bin and rebooting...
Vérification nouvelle version
À partir du moment où vous pourrez vous connecter à nouveau à votre routeur, vous retrouverez l’information relative à votre nouvelle version :
- depuis LuCI, aller vers “Status” > “Overview”, celui-ci sera affiché dans la section “System”, face à l’information “Firmware version”
- en SSH, dans la bannière de connexion affichant ce nouveau numéro de version, comme ci-dessous :
BusyBox v1.37.0 (2026-03-08 07:26:48 UTC) built-in shell (ash)
_______ ________ __
| |.-----.-----.-----.| | | |.----.| |_
| - || _ | -__| || | | || _|| _|
|_______|| __|_____|__|__||________||__| |____|
|__| W I R E L E S S F R E E D O M
-----------------------------------------------------
OpenWrt 25.12.0, r32713-f919e7899d Dave's Guitar
-----------------------------------------------------
OpenWrt recently switched to the "apk" package manager!
OPKG Command APK Equivalent Description
------------------------------------------------------------------
opkg install <pkg> apk add <pkg> Install a package
opkg remove <pkg> apk del <pkg> Remove a package
opkg upgrade apk upgrade Upgrade all packages
opkg files <pkg> apk info -L <pkg> List package contents
opkg list-installed apk info List installed packages
opkg update apk update Update package lists
opkg search <pkg> apk search <pkg> Search for packages
------------------------------------------------------------------
For more information visit:
https://openwrt.org/docs/guide-user/additional-software/opkg-to-apk-cheatsheet
root@router:~#
C’est normalement terminé, connectez-vous, et vérifiez vos différents paramètrages.