diff --git a/docs/core/install/linux-alpine.md b/docs/core/install/linux-alpine.md index d932a53a935f1..eef57a49a9042 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: 12/11/2025 +ms.date: 04/23/2026 ms.custom: linux-related-content --- @@ -25,8 +25,7 @@ The following table is a list of currently supported .NET releases and the versi |--------|-------------------|------------------------------| | 3.23 | 10, 9, 8 | 10, 9, 8 | | 3.22 | 10, 9, 8 | 9, 8 | -| 3.21 | 9, 8 | 9, 8 | -| 3.20 | 9, 8 | 8, 6 | +| 3.21 | 10, 9, 8 | 9, 8 | [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] @@ -50,16 +49,16 @@ The following table is a list of currently supported .NET releases and the versi The following table is a list of currently supported .NET releases and the architecture of Alpine they're supported on. These versions remain supported until either the version of [.NET reaches end-of-support](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) or the architecture of [Alpine is supported#](https://alpinelinux.org/releases/). Note that only `x86_64`, `armv7`, `aarch64` is officially supported by Microsoft. Other architectures are supported by the distribution maintainers, and can be installed using the `apk` package manager, if a package is available for that architecture. -| Architecture | .NET 10 | .NET 9 | .NET 8 | -|--------------|----------|-------------------|------------------------| -| x86_64 | 3.22 | 3.20, 3.21, 3.22 | 3.20, 3.21, 3.22 | -| x86 | None | None | None | -| aarch64 | 3.22 | 3.20, 3.21, 3.22 | 3.20, 3.21, 3.22 | -| armv7 | 3.22 | 3.20, 3.21, 3.22 | 3.20, 3.21, 3.22 | -| armhf | None | None | None | -| s390x | None | None | None | -| ppc64le | None | None | None | -| riscv64 | None | None | None | +| Architecture | .NET 10 | .NET 9 | .NET 8 | +|--------------|------------------|------------------|------------------| +| x86_64 | 3.21, 3.22, 3.23 | 3.21, 3.22, 3.23 | 3.21, 3.22, 3.23 | +| x86 | None | None | None | +| aarch64 | 3.21, 3.22, 3.23 | 3.21, 3.22, 3.23 | 3.21, 3.22, 3.23 | +| armv7 | 3.21, 3.22, 3.23 | 3.21, 3.22, 3.23 | 3.21, 3.22, 3.23 | +| armhf | None | None | None | +| s390x | None | None | None | +| ppc64le | None | None | None | +| riscv64 | None | None | None | ## Install preview versions @@ -73,7 +72,7 @@ The following table is a list of currently supported .NET releases and the archi 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: -### 3.20+ +### 3.21+ - ca-certificates - libgcc diff --git a/docs/core/install/linux-debian.md b/docs/core/install/linux-debian.md index 7c971f887a8fe..f7228e2e5195e 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: 11/07/2025 +ms.date: 04/23/2026 ms.custom: linux-related-content --- @@ -133,23 +133,27 @@ When you install with a package manager, these libraries are installed for you. ### 13.x +- ca-certificates - libc6 - libgcc-s1 - libgssapi-krb5-2 -- libicu72 -- libssl3 +- libicu76 +- libssl3t64 - libstdc++6 -- zlib1g +- tzdata +- zlib1g (required for .NET 8 only) ### 12.x +- ca-certificates - libc6 - libgcc-s1 - libgssapi-krb5-2 - libicu72 - libssl3 - libstdc++6 -- zlib1g +- tzdata +- zlib1g (required for .NET 8 only) ### Other notes diff --git a/docs/core/install/linux-fedora.md b/docs/core/install/linux-fedora.md index 4a2fa47fb3995..2562e1e3d16b8 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: 11/07/2025 +ms.date: 04/23/2026 ms.custom: linux-related-content --- @@ -26,7 +26,6 @@ The following table is a list of currently supported .NET releases and the versi |--------|----------| | 43 | 10, 9, 8 | | 42 | 10, 9, 8 | -| 41 | 10, 9, 8 | [!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 d23a42f447bb6..50c5775976227 100644 --- a/docs/core/install/linux-opensuse.md +++ b/docs/core/install/linux-opensuse.md @@ -3,7 +3,7 @@ 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: 11/14/2025 +ms.date: 04/23/2026 ms.custom: linux-related-content --- @@ -20,7 +20,9 @@ The following table is a list of currently supported .NET releases on openSUSE L | openSUSE Leap | .NET | |---------------|----------| | 16 | 10, 9, 8 | -| 15.6 | 10, 9, 8 | +| 15.6* | 10, 9, 8 | + +* Support ends April 30th, 2026. [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] @@ -52,16 +54,12 @@ sudo chown root:root /etc/zypp/repos.d/microsoft-prod.repo # [.NET 9](#tab/dotnet9) -openSUSE Leap 16 is newly supported with .NET. The packages for .NET 9 aren't published yet. - [!INCLUDE [linux-install-package-manager-x64-only](includes/linux-install-package-manager-x64-only.md)] [!INCLUDE [linux-zyp-install-90](includes/linux-install-90-zyp.md)] # [.NET 8](#tab/dotnet8) -openSUSE Leap 16 is newly supported with .NET. The packages for .NET 8 aren't published yet. - [!INCLUDE [linux-install-package-manager-x64-only](includes/linux-install-package-manager-x64-only.md)] [!INCLUDE [linux-zyp-install-80](includes/linux-install-80-zyp.md)] @@ -70,6 +68,9 @@ openSUSE Leap 16 is newly supported with .NET. The packages for .NET 8 aren't pu ## openSUSE Leap 15 +> [!IMPORTANT] +> Support ends April 30th, 2026. + [!INCLUDE [linux-prep-intro-generic](includes/linux-prep-intro-generic.md)] ```bash @@ -120,12 +121,18 @@ This section provides information on common errors you may get while using the p 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: +- ca-certificates +- glibc - krb5 +- libgcc_s1 - libicu -- libopenssl3 (OpenSSL 3.x) +- libopenssl3 +- libstdc++6 +- timezone +- zlib (required for .NET 8 only) > [!IMPORTANT] -> Starting with .NET 8, .NET packages for openSUSE depend on OpenSSL 3.x (libopenssl3). This change also applies to .NET 6 and .NET 7 packages. For more information, see [.NET packages for openSUSE and SLES depend on OpenSSL 3.x](../compatibility/deployment/8.0/opensuse-sles-openssl3-dependency.md). +> .NET packages for openSUSE depend on OpenSSL 3.x (libopenssl3). For more information, see [.NET packages for openSUSE and SLES depend on OpenSSL 3.x](../compatibility/deployment/8.0/opensuse-sles-openssl3-dependency.md). Dependencies can be installed with the `zypper install` command. The following snippet demonstrates installing the `krb5` library: diff --git a/docs/core/install/linux-package-mixup.md b/docs/core/install/linux-package-mixup.md index 9b8dccc406d6c..3fa30e7a6b161 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: 11/08/2025 +ms.date: 04/23/2026 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 diff --git a/docs/core/install/linux-rhel.md b/docs/core/install/linux-rhel.md index a9db1b3cf31ee..e836a1052fbd7 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: 11/14/2025 +ms.date: 04/23/2026 ms.custom: linux-related-content --- @@ -24,6 +24,8 @@ 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 10](#rhel-10) | 10, 9, 8 | diff --git a/docs/core/install/linux-scripted-manual.md b/docs/core/install/linux-scripted-manual.md index 340fb06a86504..438f99981db68 100644 --- a/docs/core/install/linux-scripted-manual.md +++ b/docs/core/install/linux-scripted-manual.md @@ -3,7 +3,7 @@ title: Install .NET on Linux without using a package manager description: Demonstrates how to install the .NET SDK and the .NET Runtime on Linux without a package manager. Use the install script or manually extract the binaries. author: adegeo ms.author: adegeo -ms.date: 11/08/2025 +ms.date: 04/23/2026 ms.custom: linux-related-content, updateeachrelease --- diff --git a/docs/core/install/linux-sles.md b/docs/core/install/linux-sles.md index 5b578ed987650..d155627a0fa55 100644 --- a/docs/core/install/linux-sles.md +++ b/docs/core/install/linux-sles.md @@ -21,7 +21,6 @@ The following table is a list of currently supported .NET releases on SLES. Thes |--------|-----------| | 16.0 | 10, 9, 8 | | 15.7 | 10, 9, 8 | -| 15.6 | 10, 9, 8 | [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] @@ -119,12 +118,16 @@ This section provides information on common errors you might get while using the 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 must make sure these libraries are installed: +- ca-certificates +- glibc - krb5 +- libgcc_s1 - libicu -- libopenssl3 (OpenSSL 3.x) +- libopenssl3 +- libstdc++6 +- timezone -> [!IMPORTANT] -> Starting with .NET 8, .NET packages for SLES depend on OpenSSL 3.x (libopenssl3). This change also applies to .NET 6 and .NET 7 packages. For more information, see [.NET packages for openSUSE and SLES depend on OpenSSL 3.x](../compatibility/deployment/8.0/opensuse-sles-openssl3-dependency.md). +For .NET 8, `libz1` (zlib) is also required. Dependencies can be installed with the `zypper install` command. The following snippet demonstrates installing the `krb5` library: diff --git a/docs/core/install/linux-snap-runtime.md b/docs/core/install/linux-snap-runtime.md index b39deefcb8d44..cda181c480e35 100644 --- a/docs/core/install/linux-snap-runtime.md +++ b/docs/core/install/linux-snap-runtime.md @@ -3,7 +3,7 @@ title: Install .NET Runtime on Linux with Snap description: Learn about how to install the .NET Runtime snap package. Canonical maintains and supports .NET-related snap packages. author: adegeo ms.author: adegeo -ms.date: 01/16/2026 +ms.date: 04/23/2026 ms.topic: install-set-up-deploy ms.custom: linux-related-content #customer intent: As a Linux user, I want to install .NET Runtime through Snap. diff --git a/docs/core/install/linux-snap-sdk.md b/docs/core/install/linux-snap-sdk.md index a64d1246686fd..b781041c1480a 100644 --- a/docs/core/install/linux-snap-sdk.md +++ b/docs/core/install/linux-snap-sdk.md @@ -3,7 +3,7 @@ title: Install .NET SDK on Linux with Snap description: Learn about how to install the .NET SDK snap package. Canonical maintains and supports .NET-related snap packages. author: adegeo ms.author: adegeo -ms.date: 11/14/2025 +ms.date: 04/23/2026 ms.topic: install-set-up-deploy ms.custom: linux-related-content, updateeachrelease ai-usage: ai-assisted @@ -41,7 +41,7 @@ Your Linux distribution might already include snap. Try running `snap` from a te Starting with .NET 9, snap packages for the .NET SDK are published under version-specific identifiers (for example, `dotnet-sdk-90` for .NET 9 and `dotnet-sdk-100` for .NET 10). Prior to .NET 9, all SDK versions were published under the same identifier `dotnet-sdk`, and you specified the version through a channel. Additionally, .NET 9 and later snap packages support both x64 and Arm64 architectures, while earlier versions only support x64. The SDK includes both the ASP.NET Core and .NET runtime, versioned to the SDK. > [!TIP] -> The [Snapcraft .NET SDK package page](https://snapcraft.io/dotnet-sdk) includes distribution-specific instructions on how to install Snapcraft and .NET. +> The [Snapcraft .NET SDK package page](https://snapcraft.io/dotnet-sdk) ([.NET 9](https://snapcraft.io/dotnet-sdk-90), [.NET 10](https://snapcraft.io/dotnet-sdk-100)) includes distribution-specific instructions on how to install Snapcraft and .NET. 01. Open a terminal. 01. Use `snap install` to install the .NET SDK snap package. @@ -73,11 +73,6 @@ The following table lists the snap packages and channels you can install: | 10 (LTS) | `dotnet-sdk-100` (preview) | | 9 (STS) | `dotnet-sdk-90` | | 8 (LTS) | `dotnet-sdk --channel 8.0/stable` | -| 7 | `dotnet-sdk --channel 7.0/stable` (out of support) | -| 6 | `dotnet-sdk --channel 6.0/stable` (out of support) | -| 5 | `dotnet-sdk --channel 5.0/stable` (out of support) | -| 3.1 | `dotnet-sdk --channel 3.1/stable` (out of support) | -| 2.1 | `dotnet-sdk --channel 2.1/stable` (out of support) | ## 2. Export the install location diff --git a/docs/core/install/linux.md b/docs/core/install/linux.md index 9ae4f0376c842..56205739844a8 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: 11/08/2025 +ms.date: 04/23/2026 --- # Install .NET on Linux diff --git a/docs/core/install/macos-notarization-issues.md b/docs/core/install/macos-notarization-issues.md index a9e247233ab03..cac7a0c19e23c 100644 --- a/docs/core/install/macos-notarization-issues.md +++ b/docs/core/install/macos-notarization-issues.md @@ -3,7 +3,7 @@ title: Working with macOS Catalina Notarization description: How to handle notarization and certificate problems with macOS when you install the .NET runtime, SDK, and apps built with .NET. author: adegeo ms.author: adegeo -ms.date: 01/16/2026 +ms.date: 04/23/2026 --- # macOS Catalina Notarization and the impact on .NET downloads and projects diff --git a/docs/core/install/macos.md b/docs/core/install/macos.md index 8927b3d6e9c3c..0f44f484be0f9 100644 --- a/docs/core/install/macos.md +++ b/docs/core/install/macos.md @@ -4,7 +4,7 @@ description: Learn about which versions of .NET SDK and .NET Runtime are support author: adegeo ms.author: adegeo ms.topic: install-set-up-deploy -ms.date: 11/08/2025 +ms.date: 04/23/2026 ms.custom: updateeachrelease, linux-related-content #customer intent: As a user or developer, I want to know which versions of .NET are supported on macOS. I also need to know how to install .NET on macOS. @@ -34,7 +34,7 @@ The following table lists the supported .NET releases, and which macOS they're s |------------------------|----------------| | macOS 26 "Tahoe" | 10.0, 9.0, 8.0 | | macOS 15 "Sequoia" | 10.0, 9.0, 8.0 | -| macOS 14 "Sonoma" | 9.0, 8.0 | +| macOS 14 "Sonoma" | 10.0, 9.0, 8.0 | [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] diff --git a/docs/core/install/remove-runtime-sdk-versions.md b/docs/core/install/remove-runtime-sdk-versions.md index 5e8471e763803..12ba134ae0f51 100644 --- a/docs/core/install/remove-runtime-sdk-versions.md +++ b/docs/core/install/remove-runtime-sdk-versions.md @@ -3,7 +3,7 @@ title: Remove the .NET runtime and SDK description: This article describes how to uninstall .NET on Windows, macOS, and Linux. Uninstall .NET manually, through a package manager, or with the .NET Uninstall Tool. author: adegeo ms.author: adegeo -ms.date: 11/08/2025 +ms.date: 04/23/2026 ms.custom: linux-related-content zone_pivot_groups: operating-systems-set-one --- diff --git a/docs/core/install/templates.md b/docs/core/install/templates.md index aa55056217285..729d86c0514e4 100644 --- a/docs/core/install/templates.md +++ b/docs/core/install/templates.md @@ -3,7 +3,7 @@ title: Install and manage SDK templates description: Learn how to install .NET templates on Windows, Linux, and macOS. Templates are installed from NuGet, a NuGet package file, or a file system directory. author: adegeo ms.author: adegeo -ms.date: 11/08/2025 +ms.date: 04/23/2026 ms.custom: linux-related-content zone_pivot_groups: operating-systems-set-one no-loc: ['dotnet new', 'dotnet nuget add source'] diff --git a/docs/core/install/upgrade.md b/docs/core/install/upgrade.md index fdd16fbd5ddbe..35675d39ad5ab 100644 --- a/docs/core/install/upgrade.md +++ b/docs/core/install/upgrade.md @@ -1,7 +1,7 @@ --- title: Upgrade to a new .NET version description: Learn how to upgrade an app to a new .NET version. Upgrade .NET when the current version goes out of support or when you want to use new features of .NET. Control versions of SDK, analyzers, and packages for predictable builds. -ms.date: 10/28/2025 +ms.date: 04/23/2026 ai-usage: ai-assisted --- diff --git a/docs/core/install/windows.md b/docs/core/install/windows.md index 20605de2f87dd..65911c9205a7e 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: 11/08/2025 +ms.date: 04/23/2026 no-loc: ["Program Files", "dotnet"] ms.custom: linux-related-content ai-usage: ai-assisted @@ -80,21 +80,18 @@ The following table is a list of currently supported .NET releases and the versi > [!TIP] > As a reminder, this table applies to modern .NET (as opposed to .NET Framework). To install .NET Framework, see the [.NET Framework installation guide](../../framework/install/index.md). -Windows 10 versions end-of-service dates are segmented by edition. Only **Home**, **Pro**, **Pro Education**, and **Pro for Workstations** editions are considered in the following table. Check the [Windows lifecycle fact sheet](https://support.microsoft.com/help/13853/windows-lifecycle-fact-sheet) for specific details. +Windows 10 support is limited to Long-Term Servicing Channel (LTSC) and Enterprise editions only. Check the [Windows lifecycle fact sheet](https://support.microsoft.com/help/13853/windows-lifecycle-fact-sheet) for specific details. | Operating System | .NET 10 (Architectures) | .NET 9 (Architectures) | .NET 8 (Architectures) | |---------------------------------------|-------------------------|------------------------|------------------------| -| Windows 11 (24H2, 23H2, 22H2 Ent/Edu) | ✔️ x64, Arm64 | ✔️ x64, Arm64 | ✔️ x64, Arm64 | -| Windows 10 (22H2) | ✔️ x64, Arm64 | ✔️ x64, Arm64 | ✔️ x64, Arm64 | -| 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 | ✔️ x64, x86 | -| Windows Server Core 2012 (and R2) | ✔️ x64, x86 | ✔️ x64, x86 | ✔️ x64, x86 | +| Windows 11 (26H1, 25H2, 24H2, 23H2 Ent/Edu) | ✔️ x64, x86, Arm64 | ✔️ x64, x86, Arm64 | ✔️ x64, x86, Arm64 | +| Windows 10 (21H2, 1809, 1607 LTSC/Enterprise) | ✔️ x64, x86, Arm64 | ✔️ x64, x86, Arm64 | ✔️ x64, x86, Arm64 | +| Windows Server (2025, 23H2, 2022, 2019, 2016, 2012 R2, 2012) | ✔️ x64 | ✔️ x64 | ✔️ x64 | +| Windows Server Core (2025, 2022, 2019, 2016, 2012 R2, 2012) | ✔️ x64 | ✔️ x64, x86 | ✔️ x64 | | Nano Server (2025, 2022, 2019) | ✔️ x64 | ✔️ x64 | ✔️ x64 | | Windows 8.1 | ❌ | ❌ | ❌ | | Windows 7 SP1 [ESU][esu] | ❌ | ❌ | ❌ | -> [!TIP] -> A `+` symbol represents the minimum version. - ### Windows 7 / 8.1 / Server 2012