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
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
---
author: adegeo
ms.author: adegeo
ms.date: 11/10/2025
ms.topic: include
ms.custom: linux-related-content
---

> [!IMPORTANT]
> The **Microsoft package feed** publishes packages for different architectures depending on the .NET version:
>
> - **.NET 10**: **x64** and **Arm64** packages only.
> - **.NET 9**: **x64** packages only.
> - **.NET 8**: **x64** packages only.
>
> If you need to install .NET on other architectures, such as **Arm32**, don't use a package manager with the Microsoft package feed. For more information on installing .NET **without a package manager**, see one of the following articles:
>
> - [Use the `install-dotnet` script to install .NET.](../linux-scripted-manual.md#scripted-install)
> - [Manually install .NET.](../linux-scripted-manual.md#manual-install)
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
---
author: adegeo
ms.author: adegeo
ms.date: 11/10/2025
ms.topic: include
ms.custom: linux-related-content
---

> [!IMPORTANT]
> The **Microsoft package feed** only publishes **x64** and **Arm64** packages for .NET 10. If you need to install .NET on other architectures, such as **Arm32**, don't use a package manager with the Microsoft package feed. For more information on installing .NET **without a package manager**, see one of the following articles:
>
> - [Use the `install-dotnet` script to install .NET.](../linux-scripted-manual.md#scripted-install)
> - [Manually install .NET.](../linux-scripted-manual.md#manual-install)
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
---
author: adegeo
ms.author: adegeo
ms.date: 11/10/2025
ms.topic: include
ms.custom: linux-related-content
---

> [!IMPORTANT]
> The **Microsoft package feed** only publishes **x64** packages for .NET 9 and .NET 8. If you need to install .NET on other architectures, such as **Arm64**, don't use a package manager with the Microsoft package feed. For more information on installing .NET **without a package manager**, see one of the following articles:
>
> - [Use the `install-dotnet` script to install .NET.](../linux-scripted-manual.md#scripted-install)
> - [Manually install .NET.](../linux-scripted-manual.md#manual-install)
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ ms.custom: linux-related-content
---

> [!IMPORTANT]
> Using a package manager to install .NET from the **Microsoft package feed** only supports the **x64** architecture. Other architectures, such as **Arm**, aren't supported by the **Microsoft package feed**. Use the Ubuntu feeds or manually install .NET. Be cautious of package mix up problems when using multiple feeds. For more information, see [.NET package mix ups on Linux](../linux-package-mixup.md?pivots=os-linux-ubuntu#whats-going-on).
> Using a package manager to install .NET from the **Microsoft package feed** only supports the **x64** architecture. Other architectures, such as **Arm64**, aren't supported by the **Microsoft package feed**. Use the Ubuntu feeds or manually install .NET. Be cautious of package mix up problems when using multiple feeds. For more information, see [.NET package mix ups on Linux](../linux-package-mixup.md?pivots=os-linux-ubuntu#whats-going-on).

For more information on installing .NET **without a package manager**, see one of the following articles:

Expand Down

This file was deleted.

30 changes: 27 additions & 3 deletions docs/core/install/linux-debian.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,6 @@ This article describes how to install .NET on Debian. When a Debian version fall

[!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 and the versions of Debian 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 version of [Debian reaches end-of-life](https://wiki.debian.org/DebianReleases).
Expand Down Expand Up @@ -44,6 +42,26 @@ sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb
```

# [.NET 10](#tab/dotnet10)

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

[!INCLUDE [linux-apt-install-100](includes/linux-install-100-apt.md)]

# [.NET 9](#tab/dotnet9)

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

[!INCLUDE [linux-apt-install-90](includes/linux-install-90-apt.md)]

# [.NET 8](#tab/dotnet8)

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

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

---

## Debian 12

[!INCLUDE [linux-prep-intro-apt](includes/linux-prep-intro-apt.md)]
Expand All @@ -56,14 +74,20 @@ rm packages-microsoft-prod.deb

# [.NET 10](#tab/dotnet10)

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

[!INCLUDE [linux-apt-install-100](includes/linux-install-100-apt.md)]

# [.NET 9](#tab/dotnet9)

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

[!INCLUDE [linux-apt-install-90](includes/linux-install-90-apt.md)]

# [.NET 8](#tab/dotnet8)

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

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

---
Expand All @@ -85,7 +109,7 @@ This section provides information on common errors you may get while using APT t

### Unable to find package

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

### Unable to locate \\ Some packages could not be installed

Expand Down
16 changes: 13 additions & 3 deletions docs/core/install/linux-opensuse.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,6 @@ ms.custom: linux-related-content

[!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 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.
Expand Down Expand Up @@ -48,14 +46,20 @@ sudo chown root:root /etc/zypp/repos.d/microsoft-prod.repo

# [.NET 10](#tab/dotnet10)

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

[!INCLUDE [linux-zyp-install-100](includes/linux-install-100-zyp.md)]

# [.NET 9](#tab/dotnet9)

[!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)

[!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 @@ -74,14 +78,20 @@ sudo chown root:root /etc/zypp/repos.d/microsoft-prod.repo

# [.NET 10](#tab/dotnet10)

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

[!INCLUDE [linux-zyp-install-100](includes/linux-install-100-zyp.md)]

# [.NET 9](#tab/dotnet9)

[!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)

[!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 @@ -96,7 +106,7 @@ This section provides information on common errors you may get while using the p

### Unable to find package

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

### Failed to fetch

Expand Down
50 changes: 50 additions & 0 deletions docs/core/install/linux-sles.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,34 @@ The following table is a list of currently supported .NET releases on SLES. Thes

[!INCLUDE [package-manager uninstall notice](./includes/linux-uninstall-preview-info.md)]

## SLES 16

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

```bash
sudo rpm -Uvh https://packages.microsoft.com/config/sles/16/packages-microsoft-prod.rpm
```

# [.NET 10](#tab/dotnet10)

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

[!INCLUDE [linux-zyp-install-100](includes/linux-install-100-zyp.md)]

# [.NET 9](#tab/dotnet9)

[!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)

[!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)]

---

## SLES 15

[!INCLUDE [linux-prep-intro-generic](includes/linux-prep-intro-generic.md)]
Expand All @@ -47,8 +75,26 @@ Currently, the SLES 15 Microsoft repository setup package installs the *microsof
sudo ln -s /etc/yum.repos.d/microsoft-prod.repo /etc/zypp/repos.d/microsoft-prod.repo
```

# [.NET 10](#tab/dotnet10)

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

[!INCLUDE [linux-zyp-install-100](includes/linux-install-100-zyp.md)]

# [.NET 9](#tab/dotnet9)

[!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)

[!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)]

---

## How to install other versions

[!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)]
Expand All @@ -57,6 +103,10 @@ sudo ln -s /etc/yum.repos.d/microsoft-prod.repo /etc/zypp/repos.d/microsoft-prod

This section provides information on common errors you may get while using the package manager to install .NET.

### Unable to find package

[!INCLUDE [linux-install-package-manager-unsupported-architectures](includes/linux-install-package-manager-unsupported-architectures.md)]

### Failed to fetch

[!INCLUDE [package-manager-failed-to-fetch-rpm](includes/package-manager-failed-to-fetch-rpm.md)]
Expand Down
2 changes: 1 addition & 1 deletion docs/core/install/linux-ubuntu-decision.md
Original file line number Diff line number Diff line change
Expand Up @@ -303,7 +303,7 @@ This section provides information on common errors you might get while using APT

#### Unable to find package

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

#### Unable to locate \\ Some packages could not be installed

Expand Down
5 changes: 3 additions & 2 deletions docs/core/install/linux.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,14 +19,15 @@ This article describes how .NET is available on various Linux distributions. .NE

## Packages

Packages are available for the following Linux distributions:
Packages are published in the Microsoft package repository at <https://packages.microsoft.com/> and are available for the following Linux distributions:

- Azure Linux
- [Debian](linux-debian.md)
- [openSUSE Leap](linux-opensuse.md)
- [SUSE Enterprise Linux](linux-sles.md)

Packages are published in the Microsoft package repository at <https://packages.microsoft.com/>. Distributions are selected per the policy defined at [dotnet/core \#9556](https://github.com/dotnet/core/discussions/9556).
> [!NOTE]
> Distributions are selected per the policy defined at [dotnet/core \#9556](https://github.com/dotnet/core/discussions/9556).

The following Linux distributions publish their own .NET packages:

Expand Down