Differences

This shows you the differences between two versions of the page.

--- en:sw:04-unipi-firmware:software-update [2026/09/14 11:56] – updated with claude and revised / copy from WIP ofojt
+++ en:sw:04-unipi-firmware:software-update [2026/09/17 10:45] (current) – ofojt
@@ Line 2: / Line 2: @@
 ====== How to install software updates ======
-<WRAP group center round box 95%>
+This article explains how to keep the software on your Unipi device up to date.
-{{ :files:img_warning-line_b.png?nolink |}}
+Update your device **regularly** — for example as part of routine maintenance. Most fixes, including security fixes, reach the device through an ordinary update, so keeping it up to date is the single most important thing you can do for its security.
-<WRAP half column 13%>
-{{ :en:hw:08_safety-instructions_pseudo-ISO-7010-info.png?nolink |(i)}}
-</WRAP>
-<WRAP half column 83%>
-**Note:** \\
-This article is still under development and some details can change. If you find any errors, please report them to our support team at [[[email protected]|[email protected]]]. Thank you.
-</WRAP>
-</WRAP>
-This article explains how to keep the software on your Unipi device up to date. For known vulnerabilities and the versions that fix them, see the [[en:sw:security|security advisories]].
+For known vulnerabilities and the versions that fix them, see the [[en:sw:security|security advisories]].
 <WRAP group center round box 95%>
@@ Line 21: / Line 13: @@
 </WRAP>
 <WRAP half column 83%>
-**Note:** \\
+**Note for Mervis users:** \\
 Normal software updates do not affect the Mervis RT license. Only a major system upgrade (for example Debian 12 to Debian 13) can invalidate it.
 </WRAP>
 </WRAP>
 ===== Before you start =====
@@ Line 32: / Line 25: @@
   * All commands below run in the device's terminal. ''sudo'' asks for the current user's password.
-===== Check your current version =====
-To find out what you are running — for example to compare it with a version named in an advisory:
+===== Updating software packages - Regular maintenance =====
-  * OS and kernel: <code>cat /etc/os-release</code> <code>uname -a</code>
+The standard update method installs the latest packages from both the Debian base system and the Unipi repository.
-  * A specific package (installed and available version): <code>apt-cache policy PACKAGE</code>
+This is the recommended method to stay up-to date with the newest features and security patches.
-  * Full details of an installed package: <code>dpkg -s PACKAGE</code>
-Replace ''PACKAGE'' with the package name, for example ''unipi-firmware6''.
-===== Update the software =====
-<WRAP group center round box 95%>
-{{ :files:img_warning-line_b.png?nolink |}}
-<WRAP half column 13%>
-{{ :en:hw:08_safety-instructions_pseudo-ISO-7010-info.png?nolink |(i)}}
-</WRAP>
-<WRAP half column 83%>
-**Tip:** \\
-Update your device **regularly** — for example as part of routine maintenance. Most fixes, including security fixes, reach the device through an ordinary update, so keeping it up to date is the single most important thing you can do for its security.
-</WRAP>
-</WRAP>
-A standard update installs the latest packages from both the Debian base system and the Unipi repository.
   * 1. Refresh the list of available packages: <code>sudo apt update</code>
   * 2. Install the available updates: <code>sudo apt upgrade</code>
   * 3. **Reboot** if the kernel, bootloader (u-boot) or IO-board firmware was updated, so the new version is used: <code>sudo reboot</code>
-  * 4. Optionally check the version again (see above) to confirm the update.
 <WRAP group center round box 95%>
@@ Line 80: / Line 53: @@
 <WRAP half column 83%>
 **Attention:** \\
-Advanced users can install one exact package version manually — for example to apply a fix on a device without internet access. Download the ''.deb'' from the [[en:sw:04-unipi-firmware:03-unipi-repo|Unipi pool]] at [[https://repo.unipi.technology/debian/pool/|repo.unipi.technology]] and install it.
+Advanced users can install Unipi packages manually — for example to apply a fix on a device without internet access. Download the ''.deb'' from the [[en:sw:04-unipi-firmware:03-unipi-repo|Unipi pool]] at [[https://repo.unipi.technology/debian/pool/|repo.unipi.technology]] and install it. Manually installing dependencies may also be required.
 </WRAP>
 </WRAP>
@@ Line 94: / Line 67: @@
 </WRAP>
 </WRAP>
+===== Updating specific packages =====
+For known vulnerabilities and the versions that fix them, see the [[en:sw:security|security advisories]].
+It is recommended to install the newest version of packages with the guide about regular maintenance above.
+To find out which package version you are running — for example to compare it with a version named in an advisory:
+  * A specific package (installed and available version): <code>apt-cache policy PACKAGE</code>
+  * Full details of an installed package: <code>dpkg -s PACKAGE</code>
+To install the specific version of the package:
+  * 1. Refresh the list of available packages: <code>sudo apt update</code>
+  * 2. Install the specific version of the package: <code>sudo apt install PACKAGE=VERSION</code>
+  * 3. **Reboot** if the kernel, bootloader (u-boot) or IO-board firmware was updated, so the new version is used: <code>sudo reboot</code>
+Replace ''PACKAGE'' with the package name, for example ''unipi-altboot''.
 ===== Platform notes =====