Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update OS release support info #43292

Merged
merged 4 commits into from
Nov 5, 2024
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
35 changes: 35 additions & 0 deletions docs/core/install/includes/linux-install-90-apt.md
Original file line number Diff line number Diff line change
@@ -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).
4 changes: 2 additions & 2 deletions docs/core/install/includes/linux-release-wait.md
Original file line number Diff line number Diff line change
@@ -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.
adegeo marked this conversation as resolved.
Show resolved Hide resolved
4 changes: 2 additions & 2 deletions docs/core/install/includes/linux-ubuntu-feed-sdk-note.md
Original file line number Diff line number Diff line change
@@ -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.
12 changes: 12 additions & 0 deletions docs/core/install/includes/linux-ubuntu-not-supported.md
Original file line number Diff line number Diff line change
@@ -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.
Original file line number Diff line number Diff line change
@@ -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).
Original file line number Diff line number Diff line change
@@ -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.
3 changes: 2 additions & 1 deletion docs/core/install/includes/versions-not-supported.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
29 changes: 9 additions & 20 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: 05/22/2024
ms.date: 11/01/2024
ms.custom: linux-related-content
---

Expand All @@ -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-80](includes/linux-install-80-apk.md)]

## Supported distributions

Expand All @@ -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
Expand All @@ -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 |
Expand Down
8 changes: 5 additions & 3 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: 05/14/2024
ms.date: 11/01/2024
ms.custom: linux-related-content
---

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

Expand Down
12 changes: 9 additions & 3 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: 05/16/2024
ms.date: 11/01/2024
ms.custom: linux-related-content
---

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

Expand Down
19 changes: 9 additions & 10 deletions docs/core/install/linux-opensuse.md
Original file line number Diff line number Diff line change
@@ -1,27 +1,26 @@
---
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)]

[!INCLUDE [linux-install-package-manager-x64-vs-arm](includes/linux-install-package-manager-x64-vs-arm.md)]

## 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)]

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

Expand Down
5 changes: 4 additions & 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: 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
Expand Down Expand Up @@ -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
Expand Down
25 changes: 14 additions & 11 deletions 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: 05/14/2024
ms.date: 11/01/2024
ms.custom: linux-related-content
---

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

Expand All @@ -47,15 +50,15 @@ 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)]

[!INCLUDE [linux-dnf-install-80](includes/linux-install-80-dnf.md)]

## 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)]

Expand Down
9 changes: 6 additions & 3 deletions docs/core/install/linux-scripted-manual.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,16 +21,19 @@ 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 |
| | 2.0 |
| | 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:
Expand Down
16 changes: 10 additions & 6 deletions docs/core/install/linux-sles.md
Original file line number Diff line number Diff line change
@@ -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)]

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

Expand Down
Loading
Loading