Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 13 additions & 14 deletions docs/core/install/linux-alpine.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
---

Expand All @@ -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)]

Expand All @@ -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

Expand All @@ -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
Expand Down
14 changes: 9 additions & 5 deletions docs/core/install/linux-debian.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
---

Expand Down Expand Up @@ -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

Expand Down
3 changes: 1 addition & 2 deletions docs/core/install/linux-fedora.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
---

Expand All @@ -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)]

Expand Down
23 changes: 15 additions & 8 deletions docs/core/install/linux-opensuse.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
---

Expand All @@ -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 |

<sup>* Support ends April 30th, 2026.</sup>
Comment thread
adegeo marked this conversation as resolved.
Comment thread
adegeo marked this conversation as resolved.

[!INCLUDE [versions-not-supported](includes/versions-not-supported.md)]

Expand Down Expand Up @@ -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)]
Expand All @@ -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.
Comment thread
adegeo marked this conversation as resolved.

[!INCLUDE [linux-prep-intro-generic](includes/linux-prep-intro-generic.md)]

```bash
Expand Down Expand Up @@ -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:

Expand Down
2 changes: 1 addition & 1 deletion docs/core/install/linux-package-mixup.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
4 changes: 3 additions & 1 deletion docs/core/install/linux-rhel.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
---

Expand All @@ -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.

<!-- Note, even though RHEL 8 is out of support, they are still publishing .NET for it -->

Comment thread
adegeo marked this conversation as resolved.
| Distribution | .NET |
|---------------------------------------|----------|
| [RHEL 10](#rhel-10) | 10, 9, 8 |
Expand Down
2 changes: 1 addition & 1 deletion docs/core/install/linux-scripted-manual.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
---

Expand Down
11 changes: 7 additions & 4 deletions docs/core/install/linux-sles.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)]

Expand Down Expand Up @@ -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:

Expand Down
2 changes: 1 addition & 1 deletion docs/core/install/linux-snap-runtime.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
9 changes: 2 additions & 7 deletions docs/core/install/linux-snap-sdk.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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.
Expand Down Expand Up @@ -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

Expand Down
2 changes: 1 addition & 1 deletion docs/core/install/linux.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/core/install/macos-notarization-issues.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
4 changes: 2 additions & 2 deletions docs/core/install/macos.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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)]

Expand Down
2 changes: 1 addition & 1 deletion docs/core/install/remove-runtime-sdk-versions.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
---
Expand Down
2 changes: 1 addition & 1 deletion docs/core/install/templates.md
Original file line number Diff line number Diff line change
Expand Up @@ -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']
Expand Down
2 changes: 1 addition & 1 deletion docs/core/install/upgrade.md
Original file line number Diff line number Diff line change
@@ -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
---

Expand Down
15 changes: 6 additions & 9 deletions docs/core/install/windows.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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<br>Windows Server 2022<br>Windows Server 2019<br>Windows Server, Version 1903 or later<br>Windows Server 2016<br>Windows Server 2012 R2<br>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 |
Comment thread
adegeo marked this conversation as resolved.
| Nano Server (2025, 2022, 2019) | ✔️ x64 | ✔️ x64 | ✔️ x64 |
| Windows 8.1 | ❌ | ❌ | ❌ |
| Windows 7 SP1 [ESU][esu] | ❌ | ❌ | ❌ |

> [!TIP]
> A `+` symbol represents the minimum version.

<a name="additional-deps"></a>

### Windows 7 / 8.1 / Server 2012
Expand Down
Loading