From 497e138820a6e60ffb0013505d57440a6584d0fa Mon Sep 17 00:00:00 2001 From: "Andy De George (adegeo)" Date: Fri, 1 Nov 2024 16:35:27 -0700 Subject: [PATCH 1/4] Update OS release support info --- .../install/includes/linux-install-90-apt.md | 35 ++++ .../includes/linux-ubuntu-not-supported.md | 12 ++ .../linux-ubuntu-package-feed-only.md | 9 + .../includes/versions-not-supported.md | 3 +- docs/core/install/linux-alpine.md | 29 +-- docs/core/install/linux-debian.md | 8 +- docs/core/install/linux-fedora.md | 12 +- docs/core/install/linux-opensuse.md | 19 +- docs/core/install/linux-rhel.md | 25 ++- docs/core/install/linux-scripted-manual.md | 9 +- docs/core/install/linux-sles.md | 16 +- docs/core/install/linux-ubuntu-install.md | 190 ++++++------------ docs/core/install/linux-ubuntu.md | 13 +- docs/core/install/linux.md | 2 +- docs/core/install/windows.md | 37 ++-- docs/zone-pivot-groups.yml | 8 +- 16 files changed, 202 insertions(+), 225 deletions(-) create mode 100644 docs/core/install/includes/linux-install-90-apt.md create mode 100644 docs/core/install/includes/linux-ubuntu-not-supported.md create mode 100644 docs/core/install/includes/linux-ubuntu-package-feed-only.md diff --git a/docs/core/install/includes/linux-install-90-apt.md b/docs/core/install/includes/linux-install-90-apt.md new file mode 100644 index 0000000000000..5340fdf766d09 --- /dev/null +++ b/docs/core/install/includes/linux-install-90-apt.md @@ -0,0 +1,35 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 11/01/2024 +ms.topic: include +ms.custom: linux-related-content +--- + +### Install the SDK + +The .NET SDK allows you to develop apps with .NET. If you install the .NET SDK, you don't need to install the corresponding runtime. To install the .NET SDK, run the following commands: + +```bash +sudo apt-get update && \ + sudo apt-get install -y dotnet-sdk-9.0 +``` + +To learn how to use the .NET CLI, see [.NET CLI overview](../../tools/index.md). + +### Install the runtime + +The ASP.NET Core Runtime allows you to run apps that were made with .NET that didn't provide the runtime. The following commands install the ASP.NET Core Runtime, which is the most compatible runtime for .NET. In your terminal, run the following commands: + +```bash +sudo apt-get update && \ + sudo apt-get install -y aspnetcore-runtime-9.0 +``` + +As an alternative to the ASP.NET Core Runtime, you can install the .NET Runtime, which doesn't include ASP.NET Core support: replace `aspnetcore-runtime-9.0` in the previous command with `dotnet-runtime-9.0`: + +```bash +sudo apt-get install -y dotnet-runtime-9.0 +``` + +To learn how to use the .NET CLI, see [.NET CLI overview](../../tools/index.md). diff --git a/docs/core/install/includes/linux-ubuntu-not-supported.md b/docs/core/install/includes/linux-ubuntu-not-supported.md new file mode 100644 index 0000000000000..4ecf995fb2011 --- /dev/null +++ b/docs/core/install/includes/linux-ubuntu-not-supported.md @@ -0,0 +1,12 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 11/01/2024 +ms.topic: include +ms.custom: linux-related-content +--- + +> [!WARNING] +> This version of Ubuntu is no longer supported. +> +> Running .NET on this version of Ubuntu is no longer supported. diff --git a/docs/core/install/includes/linux-ubuntu-package-feed-only.md b/docs/core/install/includes/linux-ubuntu-package-feed-only.md new file mode 100644 index 0000000000000..e8ac78b1b6512 --- /dev/null +++ b/docs/core/install/includes/linux-ubuntu-package-feed-only.md @@ -0,0 +1,9 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 11/01/2024 +ms.topic: include +ms.custom: linux-related-content +--- + +.NET is available in the Ubuntu package manager feeds. The Microsoft package repository no longer contains .NET packages for Ubuntu. diff --git a/docs/core/install/includes/versions-not-supported.md b/docs/core/install/includes/versions-not-supported.md index e015d91e28c8f..b698f8f9a94e4 100644 --- a/docs/core/install/includes/versions-not-supported.md +++ b/docs/core/install/includes/versions-not-supported.md @@ -1,13 +1,14 @@ --- author: adegeo ms.author: adegeo -ms.date: 05/14/2024 +ms.date: 11/01/2024 ms.topic: include --- The following versions of .NET are ❌ no longer supported: - .NET 7 +- .NET 6 (Starting November 12, 2024) - .NET 5 - .NET Core 3.1 - .NET Core 3.0 diff --git a/docs/core/install/linux-alpine.md b/docs/core/install/linux-alpine.md index 6e3e348b8c225..063c7ba871cbe 100644 --- a/docs/core/install/linux-alpine.md +++ b/docs/core/install/linux-alpine.md @@ -3,7 +3,7 @@ title: Install .NET on Alpine description: Learn about which versions of .NET SDK and .NET Runtime are supported, and how to install .NET on Alpine. author: adegeo ms.author: adegeo -ms.date: 05/22/2024 +ms.date: 11/01/2024 ms.custom: linux-related-content --- @@ -17,23 +17,9 @@ 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)] -The Alpine package manager supports installing some versions of .NET. If the .NET package is unavailable, you'll need to install .NET in one of the following alternative ways: +## Install .NET -- [Use the .NET install script.](linux-scripted-manual.md#scripted-install) -- [Download and install .NET manually.](linux-scripted-manual.md#manual-install) - -## Install .NET 8 - -.NET 8 isn't yet available in the default branch of the Alpine package repository. Use the `edge` branch to install .NET 8. Alternatively, use one of the following ways to install .NET 8: - -- [Use the .NET install script.](linux-scripted-manual.md#scripted-install) -- [Download and install .NET manually.](linux-scripted-manual.md#manual-install) - -To learn how to use the .NET CLI, see [.NET CLI overview](../tools/index.md). - -## Install .NET 6 - -[!INCLUDE [linux-apk-install-60](includes/linux-install-60-apk.md)] +[!INCLUDE [linux-apk-install-60](includes/linux-install-80-apk.md)] ## Supported distributions @@ -46,6 +32,9 @@ The following table is a list of currently supported .NET releases and the versi | 3.18 | 8.0, 6.0 | 7.0, 6.0 | | 3.17 | 8.0, 6.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)] ## Supported architectures @@ -54,10 +43,10 @@ The following table is a list of currently supported .NET releases and the archi | Architecture | .NET 6 | .NET 8 | |------------------|------------------|---------| -| x86_64 | 3.16, 3.17, 3.18, 3.19, 3.20 | 3.17, 3.18, 3.19, 3.20 | +| x86_64 | 3.17, 3.18, 3.19, 3.20 | 3.17, 3.18, 3.19, 3.20 | | x86 | None | None | -| aarch64 | 3.16, 3.17, 3.18, 3.19, 3.20 | 3.17, 3.18, 3.19, 3.20 | -| armv7 | 3.16, 3.17, 3.18, 3.19, 3.20 | 3.17, 3.18, 3.19, 3.20 | +| aarch64 | 3.17, 3.18, 3.19, 3.20 | 3.17, 3.18, 3.19, 3.20 | +| armv7 | 3.17, 3.18, 3.19, 3.20 | 3.17, 3.18, 3.19, 3.20 | | armhf | None | None | | s390x | 3.17 | 3.17 | | ppc64le | None | None | diff --git a/docs/core/install/linux-debian.md b/docs/core/install/linux-debian.md index e0a56a3ba94b0..338245e35a224 100644 --- a/docs/core/install/linux-debian.md +++ b/docs/core/install/linux-debian.md @@ -3,7 +3,7 @@ title: Install .NET on Debian description: Learn about which versions of .NET SDK and .NET Runtime are supported, and how to install .NET on Debian. author: adegeo ms.author: adegeo -ms.date: 05/14/2024 +ms.date: 11/01/2024 ms.custom: linux-related-content --- @@ -21,9 +21,11 @@ The following table is a list of currently supported .NET releases and the versi | Debian | .NET | |---------|--------| -| 12 | 8, 6 | +| 12 | 9, 8, 6 | | 11 | 8, 6 | -| 10 | 6 | + +> [!IMPORTANT] +> .NET 9 is currently in preview. [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] diff --git a/docs/core/install/linux-fedora.md b/docs/core/install/linux-fedora.md index 3c8d250265178..73ffd83b7edad 100644 --- a/docs/core/install/linux-fedora.md +++ b/docs/core/install/linux-fedora.md @@ -3,7 +3,7 @@ title: Install .NET on Fedora description: Learn about which versions of .NET SDK and .NET Runtime are supported, and how to install .NET on Fedora. author: adegeo ms.author: adegeo -ms.date: 05/16/2024 +ms.date: 11/01/2024 ms.custom: linux-related-content --- @@ -24,8 +24,14 @@ The following table is a list of currently supported .NET releases and the versi | Fedora | .NET | |--------|------------| -| 40 | 8.0, 6.0 | -| 39 | 8.0, 6.0 | +| 41 | 9.0, 8.0 | +| 40 | 9.0, 8.0, 6.0 | +| 39 | 8.0, 6.0 | + +> [!IMPORTANT] +> Fedora 39 reaches end-of-life on November 12, 2024. +> +> .NET 9 is currently in preview. [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] diff --git a/docs/core/install/linux-opensuse.md b/docs/core/install/linux-opensuse.md index 31ec5df41add6..8a9df819426ed 100644 --- a/docs/core/install/linux-opensuse.md +++ b/docs/core/install/linux-opensuse.md @@ -1,15 +1,15 @@ --- -title: Install .NET on openSUSE -description: Learn about which versions of .NET SDK and .NET Runtime are supported, and how to install .NET on openSUSE. +title: Install .NET on openSUSE Leap +description: Learn about which versions of .NET SDK and .NET Runtime are supported, and how to install .NET on openSUSE Leap. author: adegeo ms.author: adegeo -ms.date: 05/14/2024 +ms.date: 11/01/2024 ms.custom: linux-related-content --- -# Install the .NET SDK or the .NET Runtime on openSUSE +# Install the .NET SDK or the .NET Runtime on openSUSE Leap -.NET is supported on openSUSE. This article describes how to install .NET on openSUSE. +.NET is supported on openSUSE Leap. This article describes how to install .NET on openSUSE Leap. [!INCLUDE [linux-intro-sdk-vs-runtime](includes/linux-intro-sdk-vs-runtime.md)] @@ -17,11 +17,10 @@ ms.custom: linux-related-content ## Supported distributions -The following table is a list of currently supported .NET releases on openSUSE 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 is no longer supported. +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 | .NET | -|------------|-----------| -| 15.4+ | 8, 6 | +> [!IMPORTANT] +> .NET 9 is currently in preview. [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] @@ -33,7 +32,7 @@ The following table is a list of currently supported .NET releases on openSUSE 1 [!INCLUDE [package-manager uninstall notice](./includes/linux-uninstall-preview-info.md)] -## openSUSE 15 +## openSUSE Leap 15 [!INCLUDE [linux-prep-intro-generic](includes/linux-prep-intro-generic.md)] diff --git a/docs/core/install/linux-rhel.md b/docs/core/install/linux-rhel.md index c2a57ca4c3ab8..d88c8af7ec89d 100644 --- a/docs/core/install/linux-rhel.md +++ b/docs/core/install/linux-rhel.md @@ -3,7 +3,7 @@ title: Install .NET on RHEL and CentOS Stream description: Learn about which versions of .NET are supported, and how to install .NET on Red Hat Enterprise Linux and CentOS Stream. author: adegeo ms.author: adegeo -ms.date: 05/14/2024 +ms.date: 11/01/2024 ms.custom: linux-related-content --- @@ -26,14 +26,17 @@ To install .NET from Red Hat on RHEL, you first need to register using the Red H The following table is a list of currently supported .NET releases on both RHEL and CentOS Stream. 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 Linux distribution is no longer supported. -| Distribution | .NET | -| ---------------------- | --------- | -| [RHEL 9 (9.1)](#rhel-9) | 8.0, 6.0 | -| [RHEL 8 (8.7)](#rhel-8) | 8.0, 6.0 | -| [RHEL 7](#rhel-7--net-8) | 6.0 | -| [CentOS Stream 9](#centos-stream-9) | 8.0, 6.0 | -| [CentOS Stream 8](#centos-stream-8) | 8.0, 6.0 | -| [CentOS Linux is no longer supported](#where-is-centos-linux) | | +| Distribution | .NET | +|---------------------------------------------------------------|----------| +| [RHEL 9](#rhel-9) | 9.0, 8.0, 6.0 | +| [RHEL 8](#rhel-8) | 9.0, 8.0, 6.0 | +| [RHEL 7](#rhel-7--net-8) | 6.0 | +| [CentOS Stream 9](#centos-stream-9) | 9.0, 8.0, 6.0 | +| [CentOS Stream 8](#centos-stream-8) | 8.0, 6.0 | +| [CentOS Linux is no longer supported](#where-is-centos-linux) | | + +> [!IMPORTANT] +> .NET 9 is currently in preview and may not be available in the package repository. [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] @@ -47,7 +50,7 @@ The following table is a list of currently supported .NET releases on both RHEL ## RHEL 9 -.NET is included in the AppStream repositories for RHEL 9. +.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)] @@ -55,7 +58,7 @@ The following table is a list of currently supported .NET releases on both RHEL ## RHEL 8 -.NET is included in the AppStream repositories for 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)] diff --git a/docs/core/install/linux-scripted-manual.md b/docs/core/install/linux-scripted-manual.md index c66efb0236c5a..0b5f4ae7fb1d0 100644 --- a/docs/core/install/linux-scripted-manual.md +++ b/docs/core/install/linux-scripted-manual.md @@ -21,9 +21,9 @@ The following table lists the support status of each version of .NET (and .NET C | ✔️ Supported | ❌ Unsupported | |-------------|---------------| -| 8 (LTS) | 7 | -| 6 (LTS) | 5 | -| | 3.1 | +| 9 (STS) | 7 | +| 8 (LTS) | 5 | +| 6 (LTS) | 3.1 | | | 3.0 | | | 2.2 | | | 2.1 | @@ -31,6 +31,9 @@ The following table lists the support status of each version of .NET (and .NET C | | 1.1 | | | 1.0 | +> [!IMPORTANT] +> .NET 9 is currently in preview. + ## Dependencies It's possible that when you install .NET, specific dependencies may not be installed, such as when [manually installing](#manual-install). The following list details Linux distributions that are supported by Microsoft and have dependencies you may need to install. Check the distribution page for more information: diff --git a/docs/core/install/linux-sles.md b/docs/core/install/linux-sles.md index 1d023a045aa14..bccbea15e2037 100644 --- a/docs/core/install/linux-sles.md +++ b/docs/core/install/linux-sles.md @@ -1,15 +1,15 @@ --- -title: Install .NET on SLES -description: Learn about which versions of .NET SDK and .NET Runtime are supported, and how to install .NET on SLES. +title: Install .NET on SUSE Enterprise Linux +description: Learn about which versions of .NET SDK and .NET Runtime are supported, and how to install .NET on SUSE Enterprise Linux (SLES). author: adegeo ms.author: adegeo -ms.date: 05/14/2024 +ms.date: 11/01/2024 ms.custom: linux-related-content --- # Install the .NET SDK or the .NET Runtime on SLES -.NET is supported on SLES. This article describes how to install .NET on SLES. +.NET is supported on SUSE Enterprise Linux (SLES). This article describes how to install .NET on SLES. [!INCLUDE [linux-intro-sdk-vs-runtime](includes/linux-intro-sdk-vs-runtime.md)] @@ -19,8 +19,12 @@ The following table is a list of currently supported .NET releases on both SLES | SLES | .NET | |--------|------| -| 15 | 8.0, 6.0 | -| 12 SP5 | 8.0, 6.0 | +| 15.6 | 9.0, 8.0, 6.0 | +| 15.5 | 9.0, 8.0, 6.0 | +| 12 SP5 | 8.0, 6.0 | + +> [!IMPORTANT] +> .NET 9 is currently in preview. [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] diff --git a/docs/core/install/linux-ubuntu-install.md b/docs/core/install/linux-ubuntu-install.md index 492205bbc8b9b..04b3385b17589 100644 --- a/docs/core/install/linux-ubuntu-install.md +++ b/docs/core/install/linux-ubuntu-install.md @@ -3,7 +3,7 @@ title: Install .NET on Ubuntu description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Ubuntu. .NET is usually installed through APT. author: adegeo ms.author: adegeo -ms.date: 07/29/2024 +ms.date: 11/01/2024 ms.custom: linux-related-content zone_pivot_groups: ubuntu-install-set-one --- @@ -17,33 +17,32 @@ This article discusses how to install .NET on Ubuntu. [!INCLUDE [linux-install-package-manager-x64-vs-arm-ubuntu](includes/linux-install-package-manager-x64-vs-arm-ubuntu.md)] -::: zone pivot="os-linux-ubuntu-2404" +::: zone pivot="os-linux-ubuntu-2410" -## Ubuntu 24.04 +## Ubuntu 24.10 -[!INCLUDE [linux-ubuntu-package-feed-both](includes/linux-ubuntu-package-feed-both.md)] +[!INCLUDE [linux-ubuntu-package-feed-only](includes/linux-ubuntu-package-feed-only.md)] -The following versions of .NET are supported or available for Ubuntu 24.04: +The following versions of .NET are supported or available for Ubuntu 24.10: -| Supported .NET versions | Available in
built-in Ubuntu feed | [Available in
backports
Ubuntu feed](linux-ubuntu.md#ubuntu-net-backports-package-repository) | [Available in
Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | -|-------------------------|--------------------------------------|----------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------| -| 8.0, 6.0 | 8.0 | 7.0, 6.0 |None | +- 9.0 +- 8.0 -When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version. +> [!IMPORTANT] +> .NET 9 is currently in preview. -# [.NET 8](#tab/dotnet8) +When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version. -[!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] +# [.NET 9](#tab/dotnet9) -# [.NET 6](#tab/dotnet6) +[!INCLUDE [linux-apt-install-90](includes/linux-install-90-apt.md)] -> [!IMPORTANT] -> .NET 6 is available in the Ubuntu backports package repository for Ubuntu 24.04, and not the built-in package repository. For more information, see [Register the Ubuntu backports package repository](linux-ubuntu.md#register-the-ubuntu-net-backports-package-repository). After the repository is registered, use the following sections to install .NET. +# [.NET 8](#tab/dotnet8) -[!INCLUDE [linux-apt-install-60](includes/linux-install-60-apt.md)] +[!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] --- @@ -70,22 +69,20 @@ You can install a recent version of _libgdiplus_ by [adding the Mono repository ::: zone-end -::: zone pivot="os-linux-ubuntu-2310" +::: zone pivot="os-linux-ubuntu-2404" -## Ubuntu 23.10 +## Ubuntu 24.04 [!INCLUDE [linux-ubuntu-package-feed-both](includes/linux-ubuntu-package-feed-both.md)] -The following versions of .NET are supported or available for Ubuntu 23.10: +The following versions of .NET are supported or available for Ubuntu 24.04: -| Supported .NET versions | Available in
built-in Ubuntu feed | [Available in
.NET backports
Ubuntu feed](linux-ubuntu.md#ubuntu-net-backports-package-repository) | [Available in
Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | +| Supported .NET versions | Available in
built-in Ubuntu feed | [Available in
backports
Ubuntu feed](linux-ubuntu.md#ubuntu-net-backports-package-repository) | [Available in
Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | |-------------------------|--------------------------------------|----------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------| -| 8.0, 6.0 | 8.0, 7.0, 6.0 | None | 8.0, 7.0, 6.0 | - -[!INCLUDE [linux-ubuntu-feed-sdk-note](includes/linux-ubuntu-feed-sdk-note.md)] +| 8.0, 6.0 | 8.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. @@ -95,6 +92,9 @@ When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, # [.NET 6](#tab/dotnet6) +> [!IMPORTANT] +> .NET 6 is available in the Ubuntu backports package repository for Ubuntu 24.04, and not the built-in package repository. For more information, see [Register the Ubuntu backports package repository](linux-ubuntu.md#register-the-ubuntu-net-backports-package-repository). After the repository is registered, use the following sections to install .NET. + [!INCLUDE [linux-apt-install-60](includes/linux-install-60-apt.md)] --- @@ -106,8 +106,7 @@ When you install with a package manager, these libraries are installed for you. - ca-certificates - libc6 - libgcc-s1 -- libgssapi-krb5-2 -- libicu72 +- libicu74 - liblttng-ust1 - libssl3 - libstdc++6 @@ -122,12 +121,12 @@ You can install a recent version of _libgdiplus_ by [adding the Mono repository ::: zone-end -::: zone pivot="os-linux-ubuntu-2204" - +::: zone pivot="os-linux-ubuntu-2204" + ## Ubuntu 22.04 [!INCLUDE [linux-ubuntu-package-feed-both](includes/linux-ubuntu-package-feed-both.md)] @@ -235,95 +234,56 @@ You can install a recent version of _libgdiplus_ by [adding the Mono repository ::: zone-end -::: zone pivot="os-linux-ubuntu-1804" - -## Ubuntu 18.04 - -[!INCLUDE [linux-ubuntu-package-feed-ms](includes/linux-ubuntu-package-feed-ms.md)] - -The following versions of .NET are supported or available for Ubuntu 18.04: +::: zone pivot="os-linux-ubuntu-2410,os-linux-ubuntu-2404,os-linux-ubuntu-2204,os-linux-ubuntu-2004" -| Supported .NET versions | Available in
built-in Ubuntu feed | [Available in
.NET backports
Ubuntu feed](linux-ubuntu.md#ubuntu-net-backports-package-repository) | [Available in
Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | -|-------------------------|--------------------------------------|----------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------| -| 6.0 | None | None | 7.0. 6.0, 5.0, 3.1, 2.2, 2.1 | - -When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version. - -## Add the Microsoft package repository - -[!INCLUDE [linux-prep-intro-apt](includes/linux-prep-intro-apt.md)] - -```bash -wget https://packages.microsoft.com/config/ubuntu/18.04/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) - -.NET 8 isn't supported on Ubuntu 18.04. - -# [.NET 6](#tab/dotnet6) +## Unsupported versions -[!INCLUDE [linux-apt-install-60](includes/linux-install-60-apt.md)] +[!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] ---- +## How to install other versions -## Dependencies +.NET package names are standardized across all Linux distributions. The following table lists the packages: -When you install with a package manager, these libraries are installed for you. But, if you manually install .NET or you publish a self-contained app, you'll need to make sure these libraries are installed: +[!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)] -- ca-certificates -- libc6 -- libgcc1 -- libgssapi-krb5-2 -- libicu60 -- libssl1.1 -- libstdc++6 -- zlib1g +::: zone-end -[!INCLUDE [linux-ubuntu-deps-example](includes/linux-ubuntu-deps-example.md)] + -[!INCLUDE [linux-libgdiplus-general](includes/linux-libgdiplus-general.md)] +::: zone pivot="os-linux-ubuntu-other" -You can install a recent version of _libgdiplus_ by [adding the Mono repository to your system](https://www.mono-project.com/download/stable/#download-lin-ubuntu). +## Manual install -::: zone-end +If your Ubuntu version isn't supported, you most likely need to install .NET by manually extracting the binaries, by using the install script. For more information, see [Install .NET on Linux without using a package manager](linux-scripted-manual.md). -::: zone pivot="os-linux-ubuntu-1604" +## Ubuntu 23.10 -## Ubuntu 16.04 +[!INCLUDE [linux-ubuntu-not-supported](includes/linux-ubuntu-not-supported.md)] -[!INCLUDE [linux-ubuntu-package-feed-ms](includes/linux-ubuntu-package-feed-ms.md)] +[!INCLUDE [linux-ubuntu-package-feed-both](includes/linux-ubuntu-package-feed-both.md)] -The following versions of .NET are supported or available for Ubuntu 16.04: +The following versions of .NET were supported or available for Ubuntu 23.10: | Supported .NET versions | Available in
built-in Ubuntu feed | [Available in
.NET backports
Ubuntu feed](linux-ubuntu.md#ubuntu-net-backports-package-repository) | [Available in
Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | |-------------------------|--------------------------------------|----------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------| -| 6.0 | None | None | 6.0, 5.0, 3.1, 3.0, 2.2, 2.1, 2.0 | - -When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version. - -## Add the Microsoft package repository +| 8.0, 6.0 | 8.0, 7.0, 6.0 | None | 8.0, 7.0, 6.0 | -[!INCLUDE [linux-prep-intro-apt](includes/linux-prep-intro-apt.md)] +[!INCLUDE [linux-ubuntu-feed-sdk-note](includes/linux-ubuntu-feed-sdk-note.md)] -```bash -wget https://packages.microsoft.com/config/ubuntu/16.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb -sudo dpkg -i packages-microsoft-prod.deb -rm packages-microsoft-prod.deb -``` +When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version. # [.NET 8](#tab/dotnet8) -.NET 8 isn't supported on Ubuntu 16.04. +[!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] # [.NET 6](#tab/dotnet6) @@ -337,11 +297,13 @@ When you install with a package manager, these libraries are installed for you. - ca-certificates - libc6 -- libgcc1 +- libgcc-s1 - libgssapi-krb5-2 -- libicu55 -- libssl1.0.0 +- libicu72 +- liblttng-ust1 +- libssl3 - libstdc++6 +- libunwind8 - zlib1g [!INCLUDE [linux-ubuntu-deps-example](includes/linux-ubuntu-deps-example.md)] @@ -350,50 +312,17 @@ When you install with a package manager, these libraries are installed for you. You can install a recent version of _libgdiplus_ by [adding the Mono repository to your system](https://www.mono-project.com/download/stable/#download-lin-ubuntu). -::: zone-end - - - -::: zone pivot="os-linux-ubuntu-2404,os-linux-ubuntu-2310,os-linux-ubuntu-2204,os-linux-ubuntu-2004,os-linux-ubuntu-1804,os-linux-ubuntu-1604" - -## Unsupported versions - -[!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] - -## How to install other versions - -.NET package names are standardized across all Linux distributions. The following table lists the packages: - -[!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)] - -::: zone-end - - - -::: zone pivot="os-linux-ubuntu-other" - -## Manual install - -If your Ubuntu version isn't supported, you most likely need to install .NET by manually extracting the binaries, by using the install script. For more information, see [Install .NET on Linux without using a package manager](linux-scripted-manual.md). - ## Ubuntu 23.04 -> [!WARNING] -> This version of Ubuntu is no longer supported. -> -> Running .NET on this version of Ubuntu is no longer supported. +[!INCLUDE [linux-ubuntu-not-supported](includes/linux-ubuntu-not-supported.md)] [!INCLUDE [linux-ubuntu-package-feed-both](includes/linux-ubuntu-package-feed-both.md)] -The following versions of .NET are supported or available for Ubuntu 23.04: +The following versions of .NET were supported or available for Ubuntu 23.04: | Supported .NET versions | Available in
built-in Ubuntu feed | [Available in
.NET backports
Ubuntu feed](linux-ubuntu.md#ubuntu-net-backports-package-repository) | [Available in
Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | |-------------------------|--------------------------------------|----------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------| @@ -440,10 +369,7 @@ You can install a recent version of _libgdiplus_ by [adding the Mono repository ## Ubuntu 22.10 -> [!WARNING] -> This version of Ubuntu is no longer supported. -> -> Running .NET on this version of Ubuntu is no longer supported. +[!INCLUDE [linux-ubuntu-not-supported](includes/linux-ubuntu-not-supported.md)] [!INCLUDE [linux-ubuntu-package-feed-both](includes/linux-ubuntu-package-feed-both.md)] diff --git a/docs/core/install/linux-ubuntu.md b/docs/core/install/linux-ubuntu.md index bb49ec5c3f3ee..224fe24670c3a 100644 --- a/docs/core/install/linux-ubuntu.md +++ b/docs/core/install/linux-ubuntu.md @@ -9,7 +9,8 @@ ms.custom: updateeachrelease, linux-related-content # Overview of .NET on Ubuntu -This article describes how to install .NET on Ubuntu. Starting with Ubuntu 22.04, most supported versions of .NET are available in the built-in Ubuntu feed. The Ubuntu .NET backports package repository contains the remaining supported .NET versions, which are not available in the built-in Ubuntu package feed for these Ubuntu versions. For more information about available versions, see the [Supported distributions](#supported-distributions) section. +This article describes how to install .NET on Ubuntu. Starting with Ubuntu 22.04, most supported versions of .NET are available in the built-in Ubuntu feed. The Ubuntu .NET backports package repository contains the remaining supported .NET versions. For more information about available versions, see the [Supported distributions](#supported-distributions) section. + Additionally, for Ubuntu 23.10 and previous versions, the Microsoft package repository contains every version of .NET that is currently, or was previously, supported. > [!WARNING] @@ -112,7 +113,7 @@ Starting with .NET 8 on Ubuntu 24.04, Canonical supports .NET for the IBM System Install .NET through the built-in Ubuntu feed. For more information, see the following page: -- [Install .NET 8 on Ubuntu 24.04](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2404&tabs=dotnet8). +- [Install .NET 8 on Ubuntu 24.10](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2404&tabs=dotnet8). ## Supported distributions @@ -122,13 +123,17 @@ The following table is a list of currently supported .NET releases and the versi | Ubuntu | Supported .NET versions | Available in
built-in Ubuntu feed | [Available in
.NET backports
Ubuntu feed](#register-the-ubuntu-net-backports-package-repository) | [Available in
Microsoft feed](#register-the-microsoft-package-repository) | |--------------------------------------------------------------------|-------------------------|--------------------------------------|--------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------| -| [24.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2404) | 8.0, 6.0 | 8.0 | 7.0, 6.0 | None | +| [24.10](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2410) | 9.0, 8.0 | 9.0, 8.0 | None | None | +| [24.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2404) | 9.0, 8.0, 6.0 | 8.0 | 9.0, 7.0, 6.0 | None | | [23.10](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2310) | 8.0, 6.0 | 8.0, 7.0, 6.0 | None | 8.0, 7.0, 6.0 | -| [22.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2204) | 8.0, 6.0 | 8.0, 7.0, 6.0 | None | 8.0, 7.0, 6.0, 3.1 | +| [22.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2204) | 9.0, 8.0, 6.0 | 8.0, 7.0, 6.0 | 9.0 | 8.0, 7.0, 6.0, 3.1 | | [20.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2004) | 8.0, 6.0 | None | None | 8.0, 7.0. 6.0, 5.0, 3.1, 2.1 | | [18.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-1804) | 6.0 | None | None | 7.0. 6.0, 5.0, 3.1, 2.2, 2.1 | | [16.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-1604) | 6.0 | None | None | 6.0, 5.0, 3.1, 3.0, 2.2, 2.1, 2.0 | +> [!IMPORTANT] +> .NET 9 is currently in preview. + When an [Ubuntu version](https://wiki.ubuntu.com/Releases) reaches the end of its support period, .NET is no longer supported with that particular Ubuntu version. Canonical supports .NET versions in the built-in Ubuntu feed for the lifetime of that Ubuntu version, even beyond the Microsoft-provided support lifetime and provides best-effort support for .NET versions in the .NET backports package repository, which does not extend beyond the Microsoft-provided support lifetime. diff --git a/docs/core/install/linux.md b/docs/core/install/linux.md index 81f5fa010cfb5..6da1bd428aa2d 100644 --- a/docs/core/install/linux.md +++ b/docs/core/install/linux.md @@ -25,7 +25,7 @@ This article describes how .NET is available on various Linux distributions. .NE - [Debian](linux-debian.md) - [Fedora](linux-fedora.md) - [openSUSE](linux-opensuse.md) -- [SLES](linux-sles.md) +- [SUSE Enterprise Linux](linux-sles.md) - [Ubuntu](linux-ubuntu.md) .NET is [supported by Microsoft](https://github.com/dotnet/core/blob/main/microsoft-support.md) when downloaded from a Microsoft source. Best effort support is offered from Microsoft when downloaded from elsewhere. You can open issues at [dotnet/core](https://github.com/dotnet/core) if you run into problems. diff --git a/docs/core/install/windows.md b/docs/core/install/windows.md index 4c9a5c9830dd2..d76e3cc049542 100644 --- a/docs/core/install/windows.md +++ b/docs/core/install/windows.md @@ -4,7 +4,7 @@ description: "Learn about which versions of .NET SDK and .NET Runtime are suppor author: adegeo ms.author: adegeo ms.topic: install-set-up-deploy #Don't change -ms.date: 10/10/2024 +ms.date: 11/01/2024 #customer intent: As a developer or user, I want to decide the best way to install .NET on Windows. --- @@ -78,15 +78,13 @@ Windows 10 versions end-of-service dates are segmented by edition. Only **Home** | Operating System | .NET 8 (Architectures) | .NET 6 (Architectures) | |-------------------------------------|------------------------|------------------------| -| Windows 11 | ✔️ x64, x86, Arm64 | ✔️ x64, Arm64 | -| Windows Server 2022 | ✔️ x64, x86 | ✔️ x64, x86 | -| Windows 10, Version 1607 or later | ✔️ x64, x86, Arm64 | ✔️ x64, x86, Arm64 | +| Windows 11 (24H2, 23H2, 22H2 Ent/Edu) | ✔️ x64, x86, Arm64 | ✔️ x64, Arm64 | +| Windows 10 (22H2+) | ✔️ x64, x86, Arm64 | ✔️ x64, x86, Arm64 | | Windows 8.1 | ❌ | ✔️ x64, x86 | | Windows 7 SP1 [ESU][esu] | ❌ | ✔️ x64, x86 | -| Windows Server 2022
Windows Server 2019
Windows Server, Version 1903 or later
Windows Server 2016
Windows Server 2012 R2
Windows Server 2012 | ✔️ x64, x86 | ✔️ x64, x86 | +| Windows Server 2025
Windows Server 2022
Windows Server 2019
Windows Server, Version 1903 or later
Windows Server 2016
Windows Server 2012 R2
Windows Server 2012 | ✔️ x64, x86 | ✔️ x64, x86 | | Windows Server Core 2012 (and R2) | ✔️ x64, x86 | ✔️ x64, x86 | -| Nano Server, Version 1809+ | ✔️ x64 | ✔️ x64 | -| Nano Server, Version 1803 | ❌ | ❌ | +| Nano Server (2022, 2019) | ✔️ x64 | ✔️ x64 | > [!TIP] > A `+` symbol represents the minimum version. @@ -95,7 +93,11 @@ Windows 10 versions end-of-service dates are segmented by edition. Only **Home** ### Windows 7 / 8.1 / Server 2012 -While Windows 2012 is still supported with the latest version of .NET, .NET 6 was the last version to support Windows 7 and Windows 8.1. All three of these versions of Windows require further dependencies to be installed: +Windows 7 and Windows 8.1 only support .NET 6. However, .NET 6 is out of support starting November 12, 2024. + +Windows Server 2012 is still supported by any version of .NET that's still in support. + +All three of these versions of Windows require further dependencies to be installed: | Operating System | Prerequisites | |--------------------------|----------------------------------------------------------------------------------| @@ -112,20 +114,9 @@ The previous requirements are also required if you receive an error related to e ## Arm-based Windows PCs -The following sections describe things you should consider when installing .NET on an Arm-based Windows PC. - - - -### What is supported +.NET is supported on Arm-based Windows PCs. The following sections describe things you should consider when installing .NET. -The following table describes which versions of .NET are supported on an Arm-based Windows PC: - -| .NET Version | SDK | Runtime | [Path conflict](#path-conflicts) | Supported | -|--------------|-----|---------|----------------------------------| --------- | -| 8 | Yes | Yes | No | ✔️ | -| 8 | Yes | Yes | No | ✔️ | -| 6 | Yes | Yes | No | ✔️ | -| 6 | Yes | Yes | No | ✔️ | +### 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. @@ -133,10 +124,6 @@ The x86, x64, and Arm64 versions of the .NET SDK exist independently from each o 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. -### Path conflicts - -The **x64** .NET SDK installs to its own directory, as described in the previous section. This allows the Arm64 and x64 versions of the .NET SDK to exist on the same machine. However, any **x64** SDK older than 6.0, isn't supported and installs to the same location as the Arm64 version, the _C:\\Program Files\\dotnet\\_ folder. If you want to install an unsupported x64 SDK, you must uninstall the Arm64 version first. The opposite is also true. You must uninstall the unsupported x64 SDK to install the Arm64 version. - ### 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. diff --git a/docs/zone-pivot-groups.yml b/docs/zone-pivot-groups.yml index 318f532693a77..15c9c25d1a7a4 100644 --- a/docs/zone-pivot-groups.yml +++ b/docs/zone-pivot-groups.yml @@ -132,18 +132,14 @@ groups: title: Ubuntu Version prompt: Choose the Ubuntu distribution version pivots: + - id: os-linux-ubuntu-2410 + title: "24.10" - id: os-linux-ubuntu-2404 title: "24.04" - - id: os-linux-ubuntu-2310 - title: "23.10" - id: os-linux-ubuntu-2204 title: "22.04" - id: os-linux-ubuntu-2004 title: "20.04" - - id: os-linux-ubuntu-1804 - title: "18.04" - - id: os-linux-ubuntu-1604 - title: "16.04" - id: os-linux-ubuntu-other title: "Other" - id: openai-library From 47cf9ff44ed8aa7f1947a779100e02fe59e4ed0f Mon Sep 17 00:00:00 2001 From: "Andy De George (adegeo)" Date: Mon, 4 Nov 2024 09:06:59 -0800 Subject: [PATCH 2/4] Fix tabs --- docs/core/install/linux-ubuntu-install.md | 28 +++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/docs/core/install/linux-ubuntu-install.md b/docs/core/install/linux-ubuntu-install.md index 04b3385b17589..3c284ccea0b46 100644 --- a/docs/core/install/linux-ubuntu-install.md +++ b/docs/core/install/linux-ubuntu-install.md @@ -44,6 +44,10 @@ When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, [!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] +# [.NET 6](#tab/dotnet6) + +Not available. + --- ## Dependencies @@ -86,6 +90,10 @@ The following versions of .NET are supported or available for Ubuntu 24.04: 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) + +Not available. + # [.NET 8](#tab/dotnet8) [!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] @@ -141,6 +149,10 @@ The following versions of .NET are supported or available for Ubuntu 22.04: 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) + +Not available. + # [.NET 8](#tab/dotnet8) [!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] @@ -202,6 +214,10 @@ sudo dpkg -i packages-microsoft-prod.deb rm packages-microsoft-prod.deb ``` +# [.NET 9](#tab/dotnet9) + +Not available. + # [.NET 8](#tab/dotnet8) [!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] @@ -281,6 +297,10 @@ The following versions of .NET were supported or available for Ubuntu 23.10: 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) + +Not available. + # [.NET 8](#tab/dotnet8) [!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] @@ -330,6 +350,10 @@ The following versions of .NET were supported or available for Ubuntu 23.04: [!INCLUDE [linux-ubuntu-feed-sdk-note](includes/linux-ubuntu-feed-sdk-note.md)] +# [.NET 9](#tab/dotnet9) + +Not available. + # [.NET 8](#tab/dotnet8) [!INCLUDE [linux-ubuntu-80-ms](includes/linux-ubuntu-80-ms.md)] @@ -381,6 +405,10 @@ The following versions of .NET are supported or available for Ubuntu 22.10: [!INCLUDE [linux-ubuntu-feed-sdk-note](includes/linux-ubuntu-feed-sdk-note.md)] +# [.NET 9](#tab/dotnet9) + +Not available. + # [.NET 8](#tab/dotnet8) .NET 8 isn't supported on Ubuntu 22.10. From 8241c5dccece907ad117d13cb859e0b13cd331ae Mon Sep 17 00:00:00 2001 From: "Andy De George (adegeo)" Date: Mon, 4 Nov 2024 12:58:48 -0800 Subject: [PATCH 3/4] Additional updates for ubuntu --- .../install/includes/linux-release-wait.md | 4 +-- .../includes/linux-ubuntu-feed-sdk-note.md | 4 +-- .../linux-ubuntu-package-feed-both.md | 4 +-- docs/core/install/linux-alpine.md | 2 +- docs/core/install/linux-package-mixup.md | 5 +++- docs/core/install/linux-ubuntu.md | 27 ++++++++++--------- docs/core/install/linux.md | 19 ++++++++----- 7 files changed, 37 insertions(+), 28 deletions(-) diff --git a/docs/core/install/includes/linux-release-wait.md b/docs/core/install/includes/linux-release-wait.md index 8fc2626124901..a08cf07323d0a 100644 --- a/docs/core/install/includes/linux-release-wait.md +++ b/docs/core/install/includes/linux-release-wait.md @@ -1,10 +1,10 @@ --- author: adegeo ms.author: adegeo -ms.date: 11/14/2023 +ms.date: 11/04/2024 ms.topic: include ms.custom: linux-related-content --- > [!IMPORTANT] -> .NET 8 was released on November 14, 2023. It may take time for the packages to appear in the package manager feeds. +> .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-feed-sdk-note.md b/docs/core/install/includes/linux-ubuntu-feed-sdk-note.md index 82b57f32f389e..c47649f0eca1b 100644 --- a/docs/core/install/includes/linux-ubuntu-feed-sdk-note.md +++ b/docs/core/install/includes/linux-ubuntu-feed-sdk-note.md @@ -1,10 +1,10 @@ --- author: adegeo ms.author: adegeo -ms.date: 05/24/2023 +ms.date: 11/04/2024 ms.topic: include ms.custom: linux-related-content --- > [!IMPORTANT] -> .NET SDK versions offered by Canonical are always in the [.1xx feature band](../../versions/index.md#versioning-details). If you want to use a newer feature band release, use the [Microsoft feed to install the SDK](../linux-ubuntu.md#register-the-microsoft-package-repository). Make sure you review the information in the [.NET package mix ups on Linux](../linux-package-mixup.md?pivots=os-linux-ubuntu#whats-going-on) article to understand the implications of switching between repository feeds. +> If you're using .NET 8 SDK and Ubuntu 22.04, understand that SDK versions offered by Canonical are always in the [.1xx feature band](../../versions/index.md#versioning-details). If you want to use a newer feature band release, use the [Microsoft feed to install the SDK](../linux-ubuntu.md#register-the-microsoft-package-repository). Make sure you review the information in the [.NET package mix ups on Linux](../linux-package-mixup.md?pivots=os-linux-ubuntu#whats-going-on) article to understand the implications of switching between repository feeds. diff --git a/docs/core/install/includes/linux-ubuntu-package-feed-both.md b/docs/core/install/includes/linux-ubuntu-package-feed-both.md index 9758a8bf1954f..4321a94fbb95a 100644 --- a/docs/core/install/includes/linux-ubuntu-package-feed-both.md +++ b/docs/core/install/includes/linux-ubuntu-package-feed-both.md @@ -1,9 +1,9 @@ --- author: adegeo ms.author: adegeo -ms.date: 03/18/2024 +ms.date: 11/04/2024 ms.topic: include ms.custom: linux-related-content --- -.NET is available in the Ubuntu package manager feeds, as well as the Microsoft package repository. However, you should only use one or the other to install .NET. If you want to use the Microsoft package repository, see [How to register the Microsoft package repository](../linux-ubuntu.md#register-the-microsoft-package-repository). +.NET is available in the Ubuntu package manager feeds, as well as the Microsoft package repository. However, you should only use one or the other to install .NET. Microsoft recommends that you use the Ubuntu package manager feeds. If you want to use the Microsoft package repository, see [How to register the Microsoft package repository](../linux-ubuntu.md#register-the-microsoft-package-repository). diff --git a/docs/core/install/linux-alpine.md b/docs/core/install/linux-alpine.md index 063c7ba871cbe..08a18656f830e 100644 --- a/docs/core/install/linux-alpine.md +++ b/docs/core/install/linux-alpine.md @@ -19,7 +19,7 @@ If you're using Docker, consider using [official .NET Docker images](../docker/i ## Install .NET -[!INCLUDE [linux-apk-install-60](includes/linux-install-80-apk.md)] +[!INCLUDE [linux-apk-install-80](includes/linux-install-80-apk.md)] ## Supported distributions diff --git a/docs/core/install/linux-package-mixup.md b/docs/core/install/linux-package-mixup.md index abbe944472abf..8b368447baf0d 100644 --- a/docs/core/install/linux-package-mixup.md +++ b/docs/core/install/linux-package-mixup.md @@ -3,7 +3,7 @@ title: Troubleshoot .NET package mix ups on Linux description: Learn about how to troubleshoot strange .NET package errors on Linux. These errors may occur when you run the dotnet command. author: omajid ms.author: adegeo -ms.date: 03/01/2023 +ms.date: 11/04/2024 ms.custom: linux-related-content no-loc: ['usr','lib64','share','dotnet','libhostfxr.so', 'fxr', 'FrameworkList.xml', 'System.IO.FileNotFoundException'] zone_pivot_groups: operating-systems-set-two @@ -40,6 +40,9 @@ One symptom of these problems is that both the `/usr/lib64/dotnet` and `/usr/sha ## What's going on +> [!IMPORTANT] +> Starting with .NET 9 (currently in preview), Microsoft only publishes packages for supported Linux distributions that don't publish their own packages. For more information, see [Install .NET on Linux](linux.md#packages). + These errors usually occur when two Linux package repositories provide .NET packages. While Microsoft provides a Linux package repository to source .NET packages, some Linux distributions also provide .NET packages. These distributions include: - Alpine Linux diff --git a/docs/core/install/linux-ubuntu.md b/docs/core/install/linux-ubuntu.md index 224fe24670c3a..b4aa77e3d5a1a 100644 --- a/docs/core/install/linux-ubuntu.md +++ b/docs/core/install/linux-ubuntu.md @@ -3,7 +3,7 @@ title: .NET and Ubuntu overview description: Learn about the ways you can install .NET on Ubuntu, either from the built-in package feed, the .NET backports repository, or the Microsoft repository. author: adegeo ms.author: adegeo -ms.date: 05/14/2024 +ms.date: 11/04/2024 ms.custom: updateeachrelease, linux-related-content --- @@ -11,7 +11,7 @@ ms.custom: updateeachrelease, linux-related-content This article describes how to install .NET on Ubuntu. Starting with Ubuntu 22.04, most supported versions of .NET are available in the built-in Ubuntu feed. The Ubuntu .NET backports package repository contains the remaining supported .NET versions. For more information about available versions, see the [Supported distributions](#supported-distributions) section. -Additionally, for Ubuntu 23.10 and previous versions, the Microsoft package repository contains every version of .NET that is currently, or was previously, supported. +Canonical has taken over publishing .NET on Ubuntu. Starting with Ubuntu 22.04, Microsoft no longer distributes .NET for Ubuntu to the Microsoft package repository. > [!WARNING] > It's recommended that you choose between either Ubuntu or Microsoft feeds to source .NET packages. Don't mix .NET packages from multiple package repositories, as this leads to problems when apps try to resolve a specific version of .NET. @@ -23,6 +23,12 @@ Additionally, for Ubuntu 23.10 and previous versions, the Microsoft package repo | [Package manager
(Microsoft feed)](#register-the-microsoft-package-repository) |
  • Supported versions always available.
  • Patches are available right way.
  • Dependencies are included.
  • Easy removal.
|
  • Not available for Ubuntu 24.04+.
  • Requires registering the Microsoft package repository.
  • Preview releases aren't available.
  • Only supports x64 Ubuntu.
| | [Script \ Manual extraction](linux-scripted-manual.md) |
  • Control where .NET is installed.
  • Preview releases are available.
|
  • Manually install updates.
  • Manually install dependencies.
  • Manual removal.
| +## Considerations when upgrading Ubuntu + +Upgrading Ubuntu to 22.04 or later? Consider uninstalling .NET first. + +If you used a package manager to install .NET from the Microsoft package repository, you'll end up with a package mix-up problem after upgrading Ubuntu. Now that Canonical publishes .NET to the package feeds for Ubuntu 22.04 (and later versions), the package manager won't know about the previously installed .NET version. The packages can't be upgraded to the latest .NET. First, uninstall them, then reinstall them from the [Ubuntu package repository]. + ## Decide how to install .NET When your version of Ubuntu supports .NET through the built-in or .NET backports Ubuntu feed, support for those builds of .NET is provided by Canonical and the builds might be optimized for different workloads. Microsoft provides support for packages in the Microsoft package repository feed. @@ -44,9 +50,8 @@ Use the following sections to determine how you should install .NET: Install .NET through the Ubuntu feed. For more information, see the following pages: +- [Install .NET on Ubuntu 24.10](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2410). - [Install .NET on Ubuntu 24.04](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2404). -- [Install .NET on Ubuntu 23.10](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2310). -- [Install .NET on Ubuntu 23.04](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2304). - [Install .NET on Ubuntu 22.04](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2204). [!INCLUDE [linux-ubuntu-feed-sdk-note](includes/linux-ubuntu-feed-sdk-note.md)] @@ -58,8 +63,6 @@ If you're going to install the Microsoft repository to use other Microsoft packa Use the instructions on the version-specific Ubuntu page. - [20.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2004) -- [18.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-1804) -- [16.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-1604) Review the [Supported distributions](#supported-distributions) section for more information about what versions of .NET are supported for your version of Ubuntu. If you're installing a version that isn't supported, see [Register the Microsoft package repository](#register-the-microsoft-package-repository). @@ -113,7 +116,7 @@ Starting with .NET 8 on Ubuntu 24.04, Canonical supports .NET for the IBM System Install .NET through the built-in Ubuntu feed. For more information, see the following page: -- [Install .NET 8 on Ubuntu 24.10](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2404&tabs=dotnet8). +- [Install .NET 8 on Ubuntu 24.10](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2410&tabs=dotnet8). ## Supported distributions @@ -125,11 +128,8 @@ The following table is a list of currently supported .NET releases and the versi |--------------------------------------------------------------------|-------------------------|--------------------------------------|--------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------| | [24.10](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2410) | 9.0, 8.0 | 9.0, 8.0 | None | None | | [24.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2404) | 9.0, 8.0, 6.0 | 8.0 | 9.0, 7.0, 6.0 | None | -| [23.10](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2310) | 8.0, 6.0 | 8.0, 7.0, 6.0 | None | 8.0, 7.0, 6.0 | | [22.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2204) | 9.0, 8.0, 6.0 | 8.0, 7.0, 6.0 | 9.0 | 8.0, 7.0, 6.0, 3.1 | | [20.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2004) | 8.0, 6.0 | None | None | 8.0, 7.0. 6.0, 5.0, 3.1, 2.1 | -| [18.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-1804) | 6.0 | None | None | 7.0. 6.0, 5.0, 3.1, 2.2, 2.1 | -| [16.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-1604) | 6.0 | None | None | 6.0, 5.0, 3.1, 3.0, 2.2, 2.1, 2.0 | > [!IMPORTANT] > .NET 9 is currently in preview. @@ -184,6 +184,9 @@ sudo apt install software-properties-common ## Register the Microsoft package repository +> [!IMPORTANT] +> This only applies to Ubuntu versions prior to 24.04. Starting with Ubuntu 24.04, Microsoft no longer publishes packages to the Microsoft package repository. Use the [supported distributions table](#supported-distributions) to determine the best way to install .NET. + The Microsoft package repository contains all versions of .NET that were previously, or are currently, [supported with your version of Ubuntu](#supported-distributions). If your version of Ubuntu provides .NET packages, you'll need to deprioritize the Ubuntu packages and use the Microsoft repository. For instructions on how to deprioritize the packages, see [I need a version of .NET that isn't provided by my Linux distribution](linux-package-mixup.md?pivots=os-linux-ubuntu#i-need-a-version-of-net-that-isnt-provided-by-my-linux-distribution). > [!IMPORTANT] @@ -223,7 +226,7 @@ sudo apt update ## Install .NET -After you've [registered the Microsoft package repository](#register-the-microsoft-package-repository), or if the Ubuntu Feeds supports the .NET package for your Ubuntu version, you can install .NET through the package manager with the `sudo apt install ` command. Replace `` with the name of the .NET package you want to install. For example, to install .NET SDK 8.0, use the command `sudo apt install dotnet-sdk-8.0`. The following table lists the currently supported .NET packages: +Install .NET through the package manager with the `sudo apt install ` command. Replace `` with the name of the .NET package you want to install. For example, to install .NET SDK 8.0, use the command `sudo apt install dotnet-sdk-8.0`. The following table lists the currently supported .NET packages (which [may vary by your Ubuntu version](#supported-distributions)): || Product | Type | Package | |---------|--------------|---------|--------------------------| @@ -234,8 +237,6 @@ After you've [registered the Microsoft package repository](#register-the-microso | **6.0** | .NET | Runtime | `dotnet-runtime-6.0` | | **6.0** | .NET | SDK | `dotnet-sdk-6.0` | -If you want to install an unsupported version of .NET, check the [Supported distributions](#supported-distributions) section to see if that version of .NET is available. Then, substitute the **version** of .NET you want to install. For example, to install ASP.NET Core 8.0, use the package name `aspnetcore-runtime-8.0`. - > [!TIP] > If you're not creating .NET apps, install the ASP.NET Core runtime as it includes the .NET runtime and also supports ASP.NET Core apps. diff --git a/docs/core/install/linux.md b/docs/core/install/linux.md index 6da1bd428aa2d..6e8a2e61e52dd 100644 --- a/docs/core/install/linux.md +++ b/docs/core/install/linux.md @@ -4,7 +4,7 @@ description: Learn about how .NET is available on Linux. .NET can be installed t author: adegeo ms.author: adegeo ms.custom: updateeachrelease, linux-related-content -ms.date: 12/15/2023 +ms.date: 11/04/2024 --- # Install .NET on Linux @@ -19,16 +19,21 @@ This article describes how .NET is available on various Linux distributions. .NE ## Packages -.NET is available in [official package archives](https://github.com/dotnet/core/blob/main/linux.md) for various Linux distributions and [packages.microsoft.com](https://packages.microsoft.com/). +Starting with .NET 9 (currently in preview), Microsoft only publishes packages for supported Linux distributions that don't publish their own packages. Packages are published in the Microsoft package repository at . This includes the following Linux distributions: -- [Alpine](linux-alpine.md) +- Azure Linux 3.0 - [Debian](linux-debian.md) -- [Fedora](linux-fedora.md) -- [openSUSE](linux-opensuse.md) +- [openSUSE Leap](linux-opensuse.md) - [SUSE Enterprise Linux](linux-sles.md) -- [Ubuntu](linux-ubuntu.md) -.NET is [supported by Microsoft](https://github.com/dotnet/core/blob/main/microsoft-support.md) when downloaded from a Microsoft source. Best effort support is offered from Microsoft when downloaded from elsewhere. You can open issues at [dotnet/core](https://github.com/dotnet/core) if you run into problems. +The following Linux distributions officially support .NET, and publish their own .NET packages: + +- Azure Linux 2.0 (CBL-Mariner) +- [Alpine](linux-alpine.md) +- [CentOS Stream](linux-rhel.md#centos-stream-9) +- [Fedora](linux-fedora.md) +- [Red Hat Enterprise Linux (RHEL)](linux-rhel.md) +- [Ubuntu](linux-ubuntu.md) ## Snap From 814588ba1541957d117fa1e01b13cd37e4ec726e Mon Sep 17 00:00:00 2001 From: "Andy (Steve) De George" <67293991+adegeo@users.noreply.github.com> Date: Tue, 5 Nov 2024 10:02:45 -0800 Subject: [PATCH 4/4] Update docs/core/install/linux-ubuntu.md Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> --- docs/core/install/linux-ubuntu.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/install/linux-ubuntu.md b/docs/core/install/linux-ubuntu.md index b4aa77e3d5a1a..3828daf441372 100644 --- a/docs/core/install/linux-ubuntu.md +++ b/docs/core/install/linux-ubuntu.md @@ -226,7 +226,7 @@ sudo apt update ## Install .NET -Install .NET through the package manager with the `sudo apt install ` command. Replace `` with the name of the .NET package you want to install. For example, to install .NET SDK 8.0, use the command `sudo apt install dotnet-sdk-8.0`. The following table lists the currently supported .NET packages (which [may vary by your Ubuntu version](#supported-distributions)): +Install .NET through the package manager with the `sudo apt install ` command. Replace `` with the name of the .NET package you want to install. For example, to install .NET SDK 8.0, use the command `sudo apt install dotnet-sdk-8.0`. The following table lists the currently supported .NET packages (which [might vary by your Ubuntu version](#supported-distributions)): || Product | Type | Package | |---------|--------------|---------|--------------------------|