Skip to content

Commit c56be1d

Browse files
authored
Readme: describe major version upgrades using apt full-upgrade in more detail
1 parent 7841218 commit c56be1d

File tree

1 file changed

+11
-3
lines changed

1 file changed

+11
-3
lines changed

Readme.md

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -171,13 +171,21 @@ sudo apt-get full-upgrade
171171
172172
#### Major and minor versions
173173

174-
**Latest or Latest LTS installed:** If you want to update to a new major or minor version, you will need to have installed one of the [`latest[-lts]`](#latest-version) packages installed, such as `dotnet-runtime-latest` or `aspnetcore-runtime-latest-lts`, before you `apt-get update && apt-get full-upgrade`. You may clean up previous versions afterwards using `sudo apt autoremove`, or at installation time using `sudo apt full-upgrade --autoremove`.
174+
##### Latest or Latest LTS installed
175+
If you want to update to a new major or minor version, you will need to have installed one of the [`latest[-lts]`](#latest-version) packages installed, such as `dotnet-runtime-latest` or `aspnetcore-runtime-latest-lts`, before you `sudo apt-get update && sudo apt-get full-upgrade`.
175176

176-
**Specific minor version installed:** If you aren't using a `latest[-lts]` package, you can manually choose a new minor version to install using a command like `sudo apt install dotnet-runtime-8.0`. Afterwards, you may clean up previous versions using a command like `sudo apt remove dotnet-runtime-7.0`.
177+
Using `full-upgrade` instead of `upgrade` is recommended because `full-upgrade` allows removal of packages and thus enables major and minor version upgrades, in addition to patch upgrades. The difference is shown in the following example where you had .NET Runtime 9.0.10 installed with `dotnet-runtime-latest` when .NET 10.0.0 was released on 2025-11-11.
178+
- **`apt-get full-upgrade`**: installs .NET Runtime **10.0.0**, removes .NET Runtime 9.0.10
179+
- **`apt-get upgrade`**: installs .NET Runtime **9.0.11**, removes .NET Runtime 9.0.10
180+
181+
If any unneeded, automatically installed packages are left installed after upgrading, you may remove them with `sudo apt autoremove`.
182+
183+
##### Specific minor version installed
184+
If you aren't using a `latest[-lts]` package, you can manually choose a new minor version to install using a command like `sudo apt install dotnet-runtime-8.0`. Afterwards, you may clean up previous versions using a command like `sudo apt remove dotnet-runtime-7.0`.
177185

178186
#### Automatic updates
179187

180-
To automatically install package updates without any user interaction, see [Debian Reference § 2.7.3: Automatic download and upgrade of packages](https://www.debian.org/doc/manuals/debian-reference/ch02.en.html#_automatic_download_and_upgrade_of_packages) and [this quick summary](https://gist.github.com/Aldaviva/9db64e47324f467a7c9b7e468a454c76#file-debian-autoupdate-md).
188+
To automatically install package updates without any user interaction, see [Debian Reference § 2.7.3: Automatic download and upgrade of packages](https://www.debian.org/doc/manuals/debian-reference/ch02.en.html#_automatic_download_and_upgrade_of_packages) and [this quick summary](https://gist.github.com/Aldaviva/9db64e47324f467a7c9b7e468a454c76#file-debian-autoupdate-md). This uses the `apt full-upgrade` [behavior](#latest-or-latest-lts-installed), which will install new major or minor versions if you have one of the `-latest` packages installed, and will automatically remove the old version.
181189

182190
### List installed versions
183191

0 commit comments

Comments
 (0)