dotnet · dotnet-policy-service · Nov 21, 2024 · Nov 20, 2024
diff --git a/docs/core/install/includes/linux-release-wait.md b/docs/core/install/includes/linux-release-wait.md
@@ -7,4 +7,4 @@ ms.custom: linux-related-content
 ---
 
 > [!IMPORTANT]
-> .NET 9 was released on November 12, 2024. It may take time for the packages to appear in the package manager feeds, or for your specific Linux distribution to include it.
+> .NET 9 was released on November 12, 2024. It may take time for the packages to appear in the package manager feeds or for your specific Linux distribution to include it.
diff --git a/docs/core/install/includes/linux-ubuntu-register-backports.md b/docs/core/install/includes/linux-ubuntu-register-backports.md
@@ -0,0 +1,13 @@
+---
+author: adegeo
+ms.author: adegeo
+ms.date: 11/20/2024
+ms.topic: include
+ms.custom: linux-related-content
+---
+
+.NET is available in the Ubuntu .NET backports package repository. To add the repository, open a terminal and run the following command:
+
+```bash
+sudo add-apt-repository ppa:dotnet/backports
+```
diff --git a/docs/core/install/linux-alpine.md b/docs/core/install/linux-alpine.md
@@ -17,12 +17,6 @@ If you're using Docker, consider using [official .NET Docker images](../docker/i
 
 [!INCLUDE [linux-intro-sdk-vs-runtime](includes/linux-intro-sdk-vs-runtime.md)]
 
-## Install .NET
-
-[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
-
-[!INCLUDE [linux-apk-install-90](includes/linux-install-90-apk.md)]
-
 ## Supported distributions
 
 The following table is a list of currently supported .NET releases and the versions of Alpine they're supported on. These versions remain supported until either the version of [.NET reaches end-of-support](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) or the version of [Alpine reaches end-of-life](https://alpinelinux.org/releases/).
@@ -32,13 +26,25 @@ The following table is a list of currently supported .NET releases and the versi
 | 3.20   | 9.0, 8.0          | 8.0, 6.0                     |
 | 3.19   | 9.0, 8.0          | 7.0, 6.0                     |
 | 3.18   | 8.0               | 7.0, 6.0                     |
-| 3.17   | 8.0               | 7.0, 6.0                     |
-
-> [!IMPORTANT]
-> Alpine 3.17 reaches end-of-life on November 22, 2024.
 
 [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)]
 
+## Install .NET
+
+# [.NET 9](#tab/dotnet9)
+
+Not supported on Alpine 3.18.
+
+[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
+
+[!INCLUDE [linux-apk-install-90](includes/linux-install-90-apk.md)]
+
+# [.NET 8](#tab/dotnet8)
+
+[!INCLUDE [linux-apk-install-90](includes/linux-install-90-apk.md)]
+
+---
+
 ## Supported architectures
 
 The following table is a list of currently supported .NET releases and the architecture of Alpine they're supported on. These versions remain supported until either the version of [.NET reaches end-of-support](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) or the architecture of [Alpine is supported#](https://alpinelinux.org/releases/). Note that only `x86_64`, `armv7`, `aarch64` is officially supported by Microsoft. Other architectures are supported by the distribution maintainers, and can be installed using the `apk` package manager.
@@ -75,17 +81,6 @@ When you install with a package manager, these libraries are installed for you.
 - zlib
 - libgdiplus (if the .NET app requires the *System.Drawing.Common* assembly)
 
-### 3.15 - 3.17
-
-- icu-libs
-- krb5-libs
-- libgcc
-- libintl
-- libssl3
-- libstdc++
-- zlib
-- libgdiplus (if the .NET app requires the *System.Drawing.Common* assembly)
-
 Use the `apk add` command to install the dependencies.
 
 [!INCLUDE [linux-libgdiplus-general](includes/linux-libgdiplus-general.md)]

diff --git a/docs/core/install/linux-debian.md b/docs/core/install/linux-debian.md
@@ -22,7 +22,6 @@ The following table is a list of currently supported .NET releases and the versi
 | Debian | .NET    |
 |--------|---------|
 | 12     | 9, 8    |
-| 11     | 8       |
 
 [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)]
 
@@ -36,8 +35,6 @@ The following table is a list of currently supported .NET releases and the versi
 
 ## Debian 12
 
-[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
-
 [!INCLUDE [linux-prep-intro-apt](includes/linux-prep-intro-apt.md)]
 
 ```bash
@@ -46,35 +43,15 @@ sudo dpkg -i packages-microsoft-prod.deb
 rm packages-microsoft-prod.deb
 ```
 
-[!INCLUDE [linux-apt-install-90](includes/linux-install-90-apt.md)]
-
-## Debian 11
+# [.NET 9](#tab/dotnet9)
 
-[!INCLUDE [linux-prep-intro-apt](includes/linux-prep-intro-apt.md)]
+[!INCLUDE [linux-apt-install-90](includes/linux-install-90-apt.md)]
 
-```bash
-wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
-sudo dpkg -i packages-microsoft-prod.deb
-rm packages-microsoft-prod.deb
-```
+# [.NET 8](#tab/dotnet8)
 
 [!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)]
 
-## Debian 10
-
-[!INCLUDE [linux-prep-intro-apt](includes/linux-prep-intro-apt.md)]
-
-```bash
-wget https://packages.microsoft.com/config/debian/10/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
-sudo dpkg -i packages-microsoft-prod.deb
-rm packages-microsoft-prod.deb
-```
-
-[!INCLUDE [linux-apt-install-70](includes/linux-install-70-apt.md)]
-
-## How to install other versions
-
-[!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)]
+---
 
 ## Use APT to update .NET
 

diff --git a/docs/core/install/linux-fedora.md b/docs/core/install/linux-fedora.md
@@ -29,16 +29,16 @@ The following table is a list of currently supported .NET releases and the versi
 
 [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)]
 
-## Install .NET 9
+# [.NET 9](#tab/dotnet9)
 
-[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
+[!INCLUDE [linux-dnf-install-90](includes/linux-install-90-dnf.md)]
 
-[!INCLUDE [linux-dnf-install-80](includes/linux-install-90-dnf.md)]
-
-## Install .NET 8
+# [.NET 8](#tab/dotnet8)
 
 [!INCLUDE [linux-dnf-install-80](includes/linux-install-80-dnf.md)]
 
+---
+
 ## Install preview versions
 
 [!INCLUDE [preview installs don't support package managers](./includes/linux-install-previews.md)]

diff --git a/docs/core/install/linux-opensuse.md b/docs/core/install/linux-opensuse.md
@@ -19,6 +19,11 @@ ms.custom: linux-related-content
 
 The following table is a list of currently supported .NET releases on openSUSE Leap 15. These versions remain supported until either the version of [.NET reaches end-of-support](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) or the version of openSUSE Leap is no longer supported.
 
+| openSUSE Leap | .NET     |
+|---------------|----------|
+| 15.6          | 9.0, 8.0 |
+| 15.5          | 9.0, 8.0 |
+
 [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)]
 
 ## Install preview versions
@@ -41,10 +46,16 @@ sudo mv prod.repo /etc/zypp/repos.d/microsoft-prod.repo
 sudo chown root:root /etc/zypp/repos.d/microsoft-prod.repo
 ```
 
-[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
+# [.NET 9](#tab/dotnet9)
 
 [!INCLUDE [linux-zyp-install-90](includes/linux-install-90-zyp.md)]
 
+# [.NET 8](#tab/dotnet8)
+
+[!INCLUDE [linux-zyp-install-80](includes/linux-install-80-zyp.md)]
+
+---
+
 ## How to install other versions
 
 [!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)]

diff --git a/docs/core/install/linux-rhel.md b/docs/core/install/linux-rhel.md
@@ -48,16 +48,12 @@ The following table is a list of currently supported .NET releases on both RHEL
 
 .NET is included in the [AppStream repositories](https://access.redhat.com/support/policy/updates/rhel-app-streams-life-cycle) for RHEL 9.
 
-[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
-
 [!INCLUDE [linux-dnf-install-90](includes/linux-install-90-dnf.md)]
 
 ## RHEL 8
 
 .NET is included in the [AppStream repositories](https://access.redhat.com/support/policy/updates/rhel-app-streams-life-cycle) for RHEL 8.
 
-[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
-
 [!INCLUDE [linux-dnf-install-90](includes/linux-install-90-dnf.md)]
 
 ## CentOS Stream 9

diff --git a/docs/core/install/linux-sles.md b/docs/core/install/linux-sles.md
@@ -46,8 +46,6 @@ Currently, the SLES 15 Microsoft repository setup package installs the *microsof
 sudo ln -s /etc/yum.repos.d/microsoft-prod.repo /etc/zypp/repos.d/microsoft-prod.repo
 ```
 
-[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
-
 [!INCLUDE [linux-zyp-install-90](includes/linux-install-90-zyp.md)]
 
 ## How to install other versions

diff --git a/docs/core/install/linux-snap-runtime.md b/docs/core/install/linux-snap-runtime.md
@@ -39,14 +39,14 @@ The following steps install the .NET 9 runtime snap package:
 01. Use `snap install` to install the .NET Runtime snap package. For example, the following command installs the .NET 8 runtime.
 
     ```bash
-    sudo snap install dotnet-runtime-90
+    sudo snap install dotnet-runtime-80
     ```
 
 Each .NET Runtime is published as an individual snap package. The following table lists the packages:
 
 | .NET version                                      | Snap package        | .NET version supported by Microsoft |
 |---------------------------------------------------|---------------------|-----|
-| 9 (STS) *Not yet available                        | `dotnet-runtime-90` | Yes |
+| 9 (STS)                                           | Not yet available | Yes |
 | [8 (LTS)](https://snapcraft.io/dotnet-runtime-80) | `dotnet-runtime-80` | Yes |
 | [7 (STS)](https://snapcraft.io/dotnet-runtime-70) | `dotnet-runtime-70` | No  |
 | [6 (LTS)](https://snapcraft.io/dotnet-runtime-60) | `dotnet-runtime-60` | No  |

diff --git a/docs/core/install/linux-snap-sdk.md b/docs/core/install/linux-snap-sdk.md
@@ -50,15 +50,15 @@ Snap packages for the .NET SDK are all published under the same identifier: `dot
     ```
 
     - The `--classic` parameter is required.
-    - Use the `--channel` parameter to specify which version to install. If this parameter is omitted, `latest/stable` is used. For example, `--channel 9.0/stable` installs .NET SDK 9.0.
+    - Use the `--channel` parameter to specify which version to install. If this parameter is omitted, `latest/stable` is used. For example, `--channel 8.0/stable` installs .NET SDK 8.0.
 
 The `dotnet` snap alias is automatically created and mapped to the snap package's `dotnet` command.
 
 The following table lists the package channels you can install:
 
 | .NET version | Snap package channel            |
 |--------------|---------------------------------|
-| 9 (STS)      | `9.0/stable`<br>`latest/stable` |
+| 9 (STS)      | *Not yet available              |
 | 8 (LTS)      | `8.0/stable`<br>`lts/stable`    |
 | 7 (STS)      | `7.0/stable` (out of support)   |
 | 6 (LTS)      | `6.0/stable` (out of support)   |

diff --git a/docs/core/install/linux-ubuntu-install.md b/docs/core/install/linux-ubuntu-install.md
@@ -84,16 +84,16 @@ You can install a recent version of _libgdiplus_ by [adding the Mono repository
 The following versions of .NET are supported or available for Ubuntu 24.04:
 
 | Supported .NET versions | Available in<br>built-in Ubuntu feed | [Available in<br>backports<br>Ubuntu feed](linux-ubuntu.md#ubuntu-net-backports-package-repository) | [Available in<br>Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) |
-|-------------------------|--------------------------------------|----------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------|
-| 9.0, 8.0                | 8.0                                  | 7.0, 6.0                                                                                                 |None                                                                                         |
+|-------------------------|--------------------------------------|-----------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------|
+| 9.0, 8.0                | 8.0                                  | 9.0, 7.0, 6.0                                                                                       |None                                                                                         |
 
 When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version.
 
 # [.NET 9](#tab/dotnet9)
 
-[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
+[!INCLUDE [linux-ubuntu-register-backports](includes/linux-ubuntu-register-backports.md)]
 
-Not published by Microsoft.
+[!INCLUDE [linux-apt-install-90](includes/linux-install-90-apt.md)]
 
 # [.NET 8](#tab/dotnet8)
 
@@ -147,17 +147,17 @@ The following versions of .NET are supported or available for Ubuntu 22.04:
 
 | Supported .NET versions | Available in<br>built-in Ubuntu feed | [Available in<br>.NET backports<br>Ubuntu feed](linux-ubuntu.md#ubuntu-net-backports-package-repository) | [Available in<br>Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) |
 |-------------------------|--------------------------------------|----------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------|
-| 9.0, 8.0                | 8.0, 7.0, 6.0                        | None                                                                                                     | 8.0, 7.0, 6.0, 3.1                |
+| 9.0, 8.0                | 8.0, 7.0, 6.0                        | 9.0                                                                                                      | 8.0, 7.0, 6.0, 3.1                |
 
 [!INCLUDE [linux-ubuntu-feed-sdk-note](includes/linux-ubuntu-feed-sdk-note.md)]
 
 When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version.
 
 # [.NET 9](#tab/dotnet9)
 
-[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
+[!INCLUDE [linux-ubuntu-register-backports](includes/linux-ubuntu-register-backports.md)]
 
-Not published by Microsoft.
+[!INCLUDE [linux-apt-install-90](includes/linux-install-90-apt.md)]
 
 # [.NET 8](#tab/dotnet8)
 

diff --git a/docs/core/install/macos.md b/docs/core/install/macos.md
@@ -245,6 +245,20 @@ For more information about how enforced-notarization affects .NET (and your .NET
 
 [!INCLUDE [verify-download-macos-linux](includes/verify-download-macos-linux.md)]
 
+## Arm-based Macs
+
+The following sections describe things you should consider when installing .NET on an Arm-based Mac.
+
+<!-- This section is mirrored in the windows.md file. Changes here should be applied there -->
+
+### Path differences
+
+On an Arm-based Mac, all Arm64 versions of .NET are installed to the normal _/usr/local/share/dotnet/_ folder. However, when you install the **x64** version of .NET SDK, it's installed to the _/usr/local/share/dotnet/x64/dotnet/_ folder.
+
+### Path variables
+
+Environment variables that add .NET to system path, such as the `PATH` variable, might need to be changed if you have both the x64 and Arm64 versions of the .NET SDK installed. Additionally, some tools rely on the `DOTNET_ROOT` environment variable, which would also need to be updated to point to the appropriate .NET SDK installation folder.
+
 ## Troubleshooting
 
 The following sections are available to help troubleshoot issues:
@@ -283,33 +297,6 @@ Set the following two environment variables in your shell profile:
   export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
   ```
 
-### Arm-based Macs
-
-The following sections describe things you should consider when installing .NET on an Arm-based Mac.
-
-<!-- This section is mirrored in the windows.md file. Changes here should be applied there -->
-
-#### .NET Versions
-
-The following table describes which versions of .NET are supported on an Arm-based Mac:
-
-| .NET Version | SDK | Runtime |
-|--------------|-----|---------|
-| 8            | Yes | Yes     |
-| 8            | Yes | Yes     |
-| 6            | Yes | Yes     |
-| 6            | Yes | Yes     |
-
-The x64 and Arm64 versions of the .NET SDK exist independently from each other. If a new version is released, each install needs to be upgraded.
-
-#### Path differences
-
-On an Arm-based Mac, all Arm64 versions of .NET are installed to the normal _/usr/local/share/dotnet/_ folder. However, when you install the **x64** version of .NET SDK, it's installed to the _/usr/local/share/dotnet/x64/dotnet/_ folder.
-
-#### Path variables
-
-Environment variables that add .NET to system path, such as the `PATH` variable, might need to be changed if you have both the x64 and Arm64 versions of the .NET SDK installed. Additionally, some tools rely on the `DOTNET_ROOT` environment variable, which would also need to be updated to point to the appropriate .NET SDK installation folder.
-
 ### System.Drawing.Common and libgdiplus
 
 .NET applications that use the `System.Drawing.Common` assembly require `libgdiplus` to be installed.

diff --git a/docs/core/install/windows.md b/docs/core/install/windows.md
@@ -116,10 +116,6 @@ The previous requirements are also required if you receive an error related to e
 
 .NET is supported on Arm-based Windows PCs. The following sections describe things you should consider when installing .NET.
 
-### SDK differences
-
-The x86, x64, and Arm64 versions of the .NET SDK exist independently from each other. If a new version is released, each architecture install needs to be upgraded.
-
 ### Path differences
 
 On an Arm-based Windows PC, all Arm64 versions of .NET are installed to the normal _C:\\Program Files\\dotnet\\_ folder. However, the **x64** version of the .NET SDK is installed to the _C:\\Program Files\\dotnet\\x64\\_ folder.