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