diff --git a/docs/core/install/includes/linux-install-package-manager-unsupported-architectures.md b/docs/core/install/includes/linux-install-package-manager-unsupported-architectures.md new file mode 100644 index 0000000000000..fa137624f8b95 --- /dev/null +++ b/docs/core/install/includes/linux-install-package-manager-unsupported-architectures.md @@ -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) diff --git a/docs/core/install/includes/linux-install-package-manager-x64-arm64.md b/docs/core/install/includes/linux-install-package-manager-x64-arm64.md new file mode 100644 index 0000000000000..d6bc0d400247f --- /dev/null +++ b/docs/core/install/includes/linux-install-package-manager-x64-arm64.md @@ -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) diff --git a/docs/core/install/includes/linux-install-package-manager-x64-only.md b/docs/core/install/includes/linux-install-package-manager-x64-only.md new file mode 100644 index 0000000000000..8d8e5eebb2ea2 --- /dev/null +++ b/docs/core/install/includes/linux-install-package-manager-x64-only.md @@ -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) diff --git a/docs/core/install/includes/linux-install-package-manager-x64-vs-arm-ubuntu.md b/docs/core/install/includes/linux-install-package-manager-x64-vs-arm-ubuntu.md index f6551abb9397e..fb22ec5f0ce5f 100644 --- a/docs/core/install/includes/linux-install-package-manager-x64-vs-arm-ubuntu.md +++ b/docs/core/install/includes/linux-install-package-manager-x64-vs-arm-ubuntu.md @@ -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: diff --git a/docs/core/install/includes/linux-install-package-manager-x64-vs-arm.md b/docs/core/install/includes/linux-install-package-manager-x64-vs-arm.md deleted file mode 100644 index 64511c2425b7d..0000000000000 --- a/docs/core/install/includes/linux-install-package-manager-x64-vs-arm.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -author: adegeo -ms.author: adegeo -ms.date: 11/11/2024 -ms.topic: include -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**. - -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) diff --git a/docs/core/install/linux-debian.md b/docs/core/install/linux-debian.md index e964ea8511567..d4be4c9ec226d 100644 --- a/docs/core/install/linux-debian.md +++ b/docs/core/install/linux-debian.md @@ -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). @@ -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)] @@ -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)] --- @@ -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 diff --git a/docs/core/install/linux-opensuse.md b/docs/core/install/linux-opensuse.md index 1734c00c668fa..3a38e22eb6380 100644 --- a/docs/core/install/linux-opensuse.md +++ b/docs/core/install/linux-opensuse.md @@ -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. @@ -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)] --- @@ -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)] --- @@ -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 diff --git a/docs/core/install/linux-sles.md b/docs/core/install/linux-sles.md index b230cef38469d..d2414ce5c1913 100644 --- a/docs/core/install/linux-sles.md +++ b/docs/core/install/linux-sles.md @@ -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)] @@ -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)] @@ -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)] diff --git a/docs/core/install/linux-ubuntu-decision.md b/docs/core/install/linux-ubuntu-decision.md index d2a7268a3dec0..480202063ecdd 100644 --- a/docs/core/install/linux-ubuntu-decision.md +++ b/docs/core/install/linux-ubuntu-decision.md @@ -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 diff --git a/docs/core/install/linux.md b/docs/core/install/linux.md index b25f0a3f81463..9ae4f0376c842 100644 --- a/docs/core/install/linux.md +++ b/docs/core/install/linux.md @@ -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 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 . 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: