From 315ebddcfa60ad9e6410e73af94886101422d68f Mon Sep 17 00:00:00 2001 From: "Andy (Steve) De George" <67293991+adegeo@users.noreply.github.com> Date: Mon, 1 Apr 2024 09:30:22 -0700 Subject: [PATCH] Redesign of install docs for Ubuntu (#39474) * Start of tests for ubuntu redesign * add dotnet pivots * adjust pivots * adjustments * updates * Acro; Little cleaning * copy all ubuntu info into new article * Fix link * tweaks * add missing repo instructions * adjust title * linux flag * remove 22.10; ubuntu-other; redirects; * Remove individual ubuntu articles * Add 'other' ubuntu section * fix pivot * Update alpine * Update install script for deb/ubuntu * Lint * Fix ubuntu 22.04 * Unsure why that file was there... * reword include * fix script; add archived versions; archive 23.04 * Found and removed 2304 from list of all pivots * fix script --- .openpublishing.redirection.core.json | 28 + .../install/includes/linux-install-60-apt.md | 10 +- .../install/includes/linux-install-70-apt.md | 6 - .../install/includes/linux-install-80-apt.md | 6 - ...stall-package-manager-x64-vs-arm-ubuntu.md | 2 +- .../install/includes/linux-ubuntu-80-ms.md | 8 + .../linux-ubuntu-package-feed-both.md | 8 + .../includes/linux-ubuntu-package-feed-ms.md | 8 + ...kage-manager-failed-to-find-deb-classic.md | 30 + ...ckage-manager-failed-to-find-deb-intro.md} | 6 +- .../package-manager-failed-to-find-deb-new.md | 28 + .../package-manager-heading-hack-pkgname.md | 29 +- docs/core/install/linux-alpine.md | 29 +- docs/core/install/linux-debian.md | 20 +- docs/core/install/linux-ubuntu-1604.md | 71 --- docs/core/install/linux-ubuntu-1804.md | 71 --- docs/core/install/linux-ubuntu-2004.md | 71 --- docs/core/install/linux-ubuntu-2204.md | 69 --- docs/core/install/linux-ubuntu-2210.md | 74 --- docs/core/install/linux-ubuntu-2304.md | 71 --- docs/core/install/linux-ubuntu-2310.md | 71 --- docs/core/install/linux-ubuntu-install.md | 517 ++++++++++++++++++ docs/core/install/linux-ubuntu.md | 70 ++- docs/fundamentals/toc.yml | 16 +- docs/zone-pivot-groups.yml | 18 + 25 files changed, 727 insertions(+), 610 deletions(-) create mode 100644 docs/core/install/includes/linux-ubuntu-80-ms.md create mode 100644 docs/core/install/includes/linux-ubuntu-package-feed-both.md create mode 100644 docs/core/install/includes/linux-ubuntu-package-feed-ms.md create mode 100644 docs/core/install/includes/package-manager-failed-to-find-deb-classic.md rename docs/core/install/includes/{package-manager-failed-to-find-deb.md => package-manager-failed-to-find-deb-intro.md} (76%) create mode 100644 docs/core/install/includes/package-manager-failed-to-find-deb-new.md delete mode 100644 docs/core/install/linux-ubuntu-1604.md delete mode 100644 docs/core/install/linux-ubuntu-1804.md delete mode 100644 docs/core/install/linux-ubuntu-2004.md delete mode 100644 docs/core/install/linux-ubuntu-2204.md delete mode 100644 docs/core/install/linux-ubuntu-2210.md delete mode 100644 docs/core/install/linux-ubuntu-2304.md delete mode 100644 docs/core/install/linux-ubuntu-2310.md create mode 100644 docs/core/install/linux-ubuntu-install.md diff --git a/.openpublishing.redirection.core.json b/.openpublishing.redirection.core.json index e8dfbf765528b..e335b2e36c6da 100644 --- a/.openpublishing.redirection.core.json +++ b/.openpublishing.redirection.core.json @@ -781,6 +781,34 @@ "source_path_from_root": "/docs/core/install/linux-package-managers.md", "redirect_url": "/dotnet/core/install/linux" }, + { + "source_path_from_root": "/docs/core/install/linux-ubuntu-1604.md", + "redirect_url": "/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-1604" + }, + { + "source_path_from_root": "/docs/core/install/linux-ubuntu-1804.md", + "redirect_url": "/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-1804" + }, + { + "source_path_from_root": "/docs/core/install/linux-ubuntu-2004.md", + "redirect_url": "/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-2004" + }, + { + "source_path_from_root": "/docs/core/install/linux-ubuntu-2204.md", + "redirect_url": "/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-2204" + }, + { + "source_path_from_root": "/docs/core/install/linux-ubuntu-2210.md", + "redirect_url": "/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-other" + }, + { + "source_path_from_root": "/docs/core/install/linux-ubuntu-2304.md", + "redirect_url": "/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-2304" + }, + { + "source_path_from_root": "/docs/core/install/linux-ubuntu-2310.md", + "redirect_url": "/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-2310" + }, { "source_path_from_root": "/docs/core/install/runtime.md", "redirect_url": "/dotnet/core/install/windows" diff --git a/docs/core/install/includes/linux-install-60-apt.md b/docs/core/install/includes/linux-install-60-apt.md index fce939195c8a9..eb6d086e1331d 100644 --- a/docs/core/install/includes/linux-install-60-apt.md +++ b/docs/core/install/includes/linux-install-60-apt.md @@ -5,7 +5,7 @@ ms.date: 10/26/2021 ms.topic: include --- -### Install .NET 6 SDK +### 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: @@ -14,10 +14,7 @@ sudo apt-get update && \ sudo apt-get install -y dotnet-sdk-6.0 ``` -> [!IMPORTANT] -> If you receive an error message similar to **Unable to locate package dotnet-sdk-6.0**, see the [troubleshooting](#troubleshooting) section. - -### Install .NET 6 Runtime +### 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 command installs the ASP.NET Core Runtime, which is the most compatible runtime for .NET. In your terminal, run the following commands: @@ -26,9 +23,6 @@ sudo apt-get update && \ sudo apt-get install -y aspnetcore-runtime-6.0 ``` -> [!IMPORTANT] -> If you receive an error message similar to **Unable to locate package aspnetcore-runtime-6.0**, see the [troubleshooting](#troubleshooting) section. - 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-6.0` in the previous command with `dotnet-runtime-6.0`: ```bash diff --git a/docs/core/install/includes/linux-install-70-apt.md b/docs/core/install/includes/linux-install-70-apt.md index afeefe745b7b2..2579ce977e0a6 100644 --- a/docs/core/install/includes/linux-install-70-apt.md +++ b/docs/core/install/includes/linux-install-70-apt.md @@ -14,9 +14,6 @@ sudo apt-get update && \ sudo apt-get install -y dotnet-sdk-7.0 ``` -> [!IMPORTANT] -> If you receive an error message similar to **Unable to locate package dotnet-sdk-7.0**, see the [troubleshooting](#troubleshooting) section. - ### 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: @@ -26,9 +23,6 @@ sudo apt-get update && \ sudo apt-get install -y aspnetcore-runtime-7.0 ``` -> [!IMPORTANT] -> If you receive an error message similar to **Unable to locate package aspnetcore-runtime-7.0**, see the [troubleshooting](#troubleshooting) section. - 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-7.0` in the previous command with `dotnet-runtime-7.0`: ```bash diff --git a/docs/core/install/includes/linux-install-80-apt.md b/docs/core/install/includes/linux-install-80-apt.md index 8fc902a3d5d48..e653fca910633 100644 --- a/docs/core/install/includes/linux-install-80-apt.md +++ b/docs/core/install/includes/linux-install-80-apt.md @@ -14,9 +14,6 @@ sudo apt-get update && \ sudo apt-get install -y dotnet-sdk-8.0 ``` -> [!IMPORTANT] -> If you receive an error message similar to **Unable to locate package dotnet-sdk-8.0**, see the [troubleshooting](#troubleshooting) section. - ### 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: @@ -26,9 +23,6 @@ sudo apt-get update && \ sudo apt-get install -y aspnetcore-runtime-8.0 ``` -> [!IMPORTANT] -> If you receive an error message similar to **Unable to locate package aspnetcore-runtime-8.0**, see the [troubleshooting](#troubleshooting) section. - 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-8.0` in the previous command with `dotnet-runtime-8.0`: ```bash 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 3b39d12704490..b4ccce66e0989 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 feed or manually install .NET. Be cautious of package mix up problems. 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 **Arm**, aren't supported by the **Microsoft package feed**. Use the Ubuntu feed 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-ubuntu-80-ms.md b/docs/core/install/includes/linux-ubuntu-80-ms.md new file mode 100644 index 0000000000000..267bbc599869f --- /dev/null +++ b/docs/core/install/includes/linux-ubuntu-80-ms.md @@ -0,0 +1,8 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 03/19/2024 +ms.topic: include +--- + +.NET 8.0 isn't available in the Ubuntu package repository. [Register the Microsoft package repository](../linux-ubuntu.md#register-the-microsoft-package-repository) and use that feed to install .NET through APT. If you use the Microsoft package repository to install .NET, you should deprioritize .NET packages from the Ubuntu repository. For more information, see [I need a version of .NET that isn't provided by my Linux distribution](../linux-package-mixup.md?pivots=os-linux-ubuntu#i-need-a-version-of-net-that-isnt-provided-by-my-linux-distribution). diff --git a/docs/core/install/includes/linux-ubuntu-package-feed-both.md b/docs/core/install/includes/linux-ubuntu-package-feed-both.md new file mode 100644 index 0000000000000..277e0a11bcb3b --- /dev/null +++ b/docs/core/install/includes/linux-ubuntu-package-feed-both.md @@ -0,0 +1,8 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 03/18/2024 +ms.topic: include +--- + +.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). diff --git a/docs/core/install/includes/linux-ubuntu-package-feed-ms.md b/docs/core/install/includes/linux-ubuntu-package-feed-ms.md new file mode 100644 index 0000000000000..27ac855fb5cf4 --- /dev/null +++ b/docs/core/install/includes/linux-ubuntu-package-feed-ms.md @@ -0,0 +1,8 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 03/18/2024 +ms.topic: include +--- + +The default Ubuntu package repository doesn't contain this version of .NET. Use the [Microsoft package repository instead](../linux-ubuntu.md#register-the-microsoft-package-repository). diff --git a/docs/core/install/includes/package-manager-failed-to-find-deb-classic.md b/docs/core/install/includes/package-manager-failed-to-find-deb-classic.md new file mode 100644 index 0000000000000..6cfd2e9f02939 --- /dev/null +++ b/docs/core/install/includes/package-manager-failed-to-find-deb-classic.md @@ -0,0 +1,30 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 03/29/2024 +ms.topic: include +ms.custom: linux-related-content +--- + +```bash +# Define the OS version, name, and codename +source /etc/os-release + +# Download the Microsoft keys +sudo apt-get install -y gpg wget +wget https://packages.microsoft.com/keys/microsoft.asc +cat microsoft.asc | gpg --dearmor -o microsoft.asc.gpg +sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/ + +# Add the Microsoft repository to the system's sources list +wget https://packages.microsoft.com/config/$ID/$VERSION_ID/prod.list +sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list + +# Set ownership +sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg +sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list + +# Update packages and install .NET +sudo apt-get update && \ + sudo apt-get install -y {dotnet-package} +``` diff --git a/docs/core/install/includes/package-manager-failed-to-find-deb.md b/docs/core/install/includes/package-manager-failed-to-find-deb-intro.md similarity index 76% rename from docs/core/install/includes/package-manager-failed-to-find-deb.md rename to docs/core/install/includes/package-manager-failed-to-find-deb-intro.md index 73e9554391599..5527e151d5ee3 100644 --- a/docs/core/install/includes/package-manager-failed-to-find-deb.md +++ b/docs/core/install/includes/package-manager-failed-to-find-deb-intro.md @@ -1,8 +1,9 @@ --- author: adegeo ms.author: adegeo -ms.date: 11/14/2023 +ms.date: 03/29/2024 ms.topic: include +ms.custom: linux-related-content --- If you receive an error message similar to **Unable to locate package {dotnet-package}** or **Some packages could not be installed**, run the following commands. @@ -12,9 +13,6 @@ There are two placeholders in the following set of commands. - `{dotnet-package}`\ This represents the .NET package you're installing, such as `aspnetcore-runtime-8.0`. This is used in the following `sudo apt-get install` command. -- `{os-version}`\ -This represents the distribution version you're on. This is used in the `wget` command below. The distribution version is the numerical value, such as `20.04` on Ubuntu or `10` on Debian. - First, try purging the package list: ```bash diff --git a/docs/core/install/includes/package-manager-failed-to-find-deb-new.md b/docs/core/install/includes/package-manager-failed-to-find-deb-new.md new file mode 100644 index 0000000000000..591171a38a55e --- /dev/null +++ b/docs/core/install/includes/package-manager-failed-to-find-deb-new.md @@ -0,0 +1,28 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 03/29/2024 +ms.topic: include +ms.custom: linux-related-content +--- + +```bash +# Define the OS version, name, and codename +source /etc/os-release + +# Download the Microsoft keys +sudo apt-get install -y gpg wget +wget https://packages.microsoft.com/keys/microsoft.asc +cat microsoft.asc | gpg --dearmor -o microsoft.asc.gpg + +# Add the Microsoft repository to the system's sources list +wget https://packages.microsoft.com/config/$ID/$VERSION_ID/prod.list +sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list + +# Move the key to the appropriate place +sudo mv microsoft.asc.gpg $(cat /etc/apt/sources.list.d/microsoft-prod.list | grep -oP "(?<=signed-by=).*(?=\])") + +# Update packages and install .NET +sudo apt-get update && \ + sudo apt-get install -y {dotnet-package} +``` diff --git a/docs/core/install/includes/package-manager-heading-hack-pkgname.md b/docs/core/install/includes/package-manager-heading-hack-pkgname.md index 618cb426e0e0c..fde2929f5dfb2 100644 --- a/docs/core/install/includes/package-manager-heading-hack-pkgname.md +++ b/docs/core/install/includes/package-manager-heading-hack-pkgname.md @@ -1,35 +1,35 @@ --- author: adegeo ms.author: adegeo -ms.date: 11/14/2023 +ms.date: 03/18/2024 ms.topic: include --- -All versions of .NET are available for download at , but require [manual installation](../linux-scripted-manual.md). You can try and use the package manager to install a different version of .NET. However, the requested version may not be available. +All versions of .NET are available for download at , but require [manual installation](../linux-scripted-manual.md). You can try to use the package manager to install a different version of .NET. However, the requested version might not be available. The packages added to package manager feeds are named in a hackable format, for example: `{product}-{type}-{version}`. - **product**\ The type of .NET product to install. Valid options are: - - dotnet - - aspnetcore + - `dotnet` + - `aspnetcore` - **type**\ Chooses the SDK or the runtime. Valid options are: - - sdk (only available for the **dotnet** product) - - runtime + - `sdk` (only available for the **dotnet** product) + - `runtime` - **version**\ -The version of the SDK or runtime to install. This article will always give the instructions for the latest supported version. Valid options are any released version, such as: +The version of the SDK or runtime to install. Valid options are any released version, such as: - - 8.0 - - 6.0 - - 3.1 - - 2.1 + - `8.0` + - `6.0` + - `3.1` + - `2.1` - It's possible the SDK/runtime you're trying to download is not available for your Linux distribution. For a list of supported distributions, see [Install .NET on Linux](../linux.md). + It's possible the SDK/runtime you're trying to download isn't available for your Linux distribution. For a list of supported distributions, see [Install .NET on Linux](../linux.md). ### Examples @@ -38,6 +38,9 @@ The version of the SDK or runtime to install. This article will always give the - Install the .NET 5 SDK: `dotnet-sdk-5.0` - Install the .NET Core 3.1 SDK: `dotnet-sdk-3.1` +> [!NOTE] +> Some package might not be available on your Linux distribution. + ### Package missing -If the package-version combination doesn't work, it's not available. For example, there isn't an ASP.NET Core SDK, the SDK components are included with the .NET SDK. The value `aspnetcore-sdk-8.0` is incorrect and should be `dotnet-sdk-8.0`. For a list of Linux distributions supported by .NET, see [.NET dependencies and requirements](../linux.md). +If the package-version combination doesn't work, it's not available. For example, there isn't an ASP.NET Core SDK. The SDK components for ASP.NET Core are included with the .NET SDK. The value `aspnetcore-sdk-8.0` is incorrect and should be `dotnet-sdk-8.0`. For a list of Linux distributions supported by .NET, see [.NET dependencies and requirements](../linux.md). diff --git a/docs/core/install/linux-alpine.md b/docs/core/install/linux-alpine.md index f52f21fe15435..0120902e8a113 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: Demonstrates the various ways to install .NET SDK and .NET Runtime on Alpine. author: adegeo ms.author: adegeo -ms.date: 01/09/2024 +ms.date: 03/26/2024 ms.custom: linux-related-content --- @@ -24,7 +24,7 @@ The Alpine package manager supports installing some versions of .NET. If the .NE ## Install .NET 8 -.NET 8 isn't yet available in the official Alpine package repository. Use one of the following ways to 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) @@ -43,6 +43,7 @@ The following table is a list of currently supported .NET releases and the versi | Alpine | Supported Version | Available in Package Manager | |--------|--------------------| -----------------------------| +| 3.19 | .NET 8.0, .NET 7.0, .NET 6.0 | .NET 7.0, .NET 6.0 | | 3.18 | .NET 8.0, .NET 7.0, .NET 6.0 | .NET 7.0, .NET 6.0 | | 3.17 | .NET 8.0, .NET 7.0, .NET 6.0 | .NET 7.0, .NET 6.0 | | 3.16 | .NET 7.0, .NET 6.0 | .NET 6.0 | @@ -77,25 +78,31 @@ 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.18+ + +- ca-certificates-bundle +- libgcc +- libssl3 +- libstdc++ +- zlib +- libgdiplus (if the .NET app requires the *System.Drawing.Common* assembly) + +### 3.15 - 3.17 + - icu-libs - krb5-libs - libgcc -- libgdiplus (if the .NET app requires the *System.Drawing.Common* assembly) - libintl -- libssl1.1 (for 3.14.x and older) -- libssl3 (for 3.15.x and newer) +- libssl3 - libstdc++ - zlib +- libgdiplus (if the .NET app requires the *System.Drawing.Common* assembly) -To install the needed requirements, run the following command: - -```bash -apk add bash icu-libs krb5-libs libgcc libintl libssl1.1 libstdc++ zlib -``` +Use the `apk add` command to install the dependencies. [!INCLUDE [linux-libgdiplus-general](includes/linux-libgdiplus-general.md)] -To install libgdiplus on Alpine 3.16 or later, run: +To install `libgdiplus`, run: ```bash apk add libgdiplus diff --git a/docs/core/install/linux-debian.md b/docs/core/install/linux-debian.md index f74414dc23529..d9b8dc09c9084 100644 --- a/docs/core/install/linux-debian.md +++ b/docs/core/install/linux-debian.md @@ -96,19 +96,15 @@ This section provides information on common errors you may get while using APT t ### Unable to locate \\ Some packages could not be installed -[!INCLUDE [package-manager-failed-to-find-deb](includes/package-manager-failed-to-find-deb.md)] +[!INCLUDE [package-manager-failed-to-find-deb-intro](includes/package-manager-failed-to-find-deb-intro.md)] -```bash -sudo apt-get install -y gpg -wget -O - https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor -o microsoft.asc.gpg -sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/ -wget https://packages.microsoft.com/config/debian/{os-version}/prod.list -sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list -sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg -sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list -sudo apt-get update && \ - sudo apt-get install -y {dotnet-package} -``` +If you're using Debian 12 or later, try the following commands: + +[!INCLUDE [package-manager-failed-to-find-deb-new](includes/package-manager-failed-to-find-deb-new.md)] + +If you're using a Debian version prior to 12, try the following commands: + +[!INCLUDE [package-manager-failed-to-find-deb-classic](includes/package-manager-failed-to-find-deb-classic.md)] ### Failed to fetch diff --git a/docs/core/install/linux-ubuntu-1604.md b/docs/core/install/linux-ubuntu-1604.md deleted file mode 100644 index c95edcd901c36..0000000000000 --- a/docs/core/install/linux-ubuntu-1604.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Install .NET on Ubuntu 16.04 -description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Ubuntu 16.04. -author: adegeo -ms.author: adegeo -ms.date: 03/01/2023 -ms.custom: linux-related-content ---- - -# Install .NET SDK or .NET Runtime on Ubuntu 16.04 - -This article discusses how to install .NET on Ubuntu 16.04; Only .NET 6 is supported. - -[!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 versions - -The following versions of .NET are supported or available for Ubuntu 16.04: - -| Supported .NET versions | Available in Ubuntu feed | [Available in Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | -|-------------------------|--------------------------|-----------------------------------| -| 6.0 | None | 6.0, 5.0, 3.1, 3.0, 2.2, 2.1, 2.0 | - -When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version. - -[!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] - -## Add the Microsoft package repository - -[!INCLUDE [linux-prep-intro-apt](includes/linux-prep-intro-apt.md)] - -```bash -wget https://packages.microsoft.com/config/ubuntu/16.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb -sudo dpkg -i packages-microsoft-prod.deb -rm packages-microsoft-prod.deb -``` - -[!INCLUDE [linux-apt-install-60](includes/linux-install-60-apt.md)] - -## How to install other versions - -[!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)] - -## Troubleshooting - -If you run into issues installing or even running .NET, see [Troubleshooting](linux-ubuntu.md#troubleshooting). - -## Dependencies - -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: - -- libc6 -- libgcc1 -- libgssapi-krb5-2 -- libicu55 -- libssl1.0.0 -- libstdc++6 -- zlib1g - -[!INCLUDE [linux-ubuntu-deps-example](includes/linux-ubuntu-deps-example.md)] - -[!INCLUDE [linux-libgdiplus-general](includes/linux-libgdiplus-general.md)] - -You can install a recent version of *libgdiplus* by [adding the Mono repository to your system](https://www.mono-project.com/download/stable/#download-lin-ubuntu). - -## Next steps - -- [How to enable TAB completion for the .NET CLI](../tools/enable-tab-autocomplete.md) -- [Tutorial: Create a console application with .NET SDK using Visual Studio Code](../tutorials/with-visual-studio-code.md) diff --git a/docs/core/install/linux-ubuntu-1804.md b/docs/core/install/linux-ubuntu-1804.md deleted file mode 100644 index 6dd255a7c2faf..0000000000000 --- a/docs/core/install/linux-ubuntu-1804.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Install .NET on Ubuntu 18.04 -description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Ubuntu 18.04. -author: adegeo -ms.author: adegeo -ms.date: 03/01/2023 -ms.custom: linux-related-content ---- - -# Install .NET SDK or .NET Runtime on Ubuntu 18.04 - -This article discusses how to install .NET on Ubuntu 18.04; .NET 6 and .NET 7 are supported. - -[!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 versions - -The following versions of .NET are supported or available for Ubuntu 18.04: - -| Supported .NET versions | Available in Ubuntu feed | [Available in Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | -|-------------------------|--------------------------|-----------------------------------| -| 7.0, 6.0 | None | 7.0. 6.0, 5.0, 3.1, 2.2, 2.1 | - -When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version. - -[!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] - -## Add the Microsoft package repository - -[!INCLUDE [linux-prep-intro-apt](includes/linux-prep-intro-apt.md)] - -```bash -wget https://packages.microsoft.com/config/ubuntu/18.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb -sudo dpkg -i packages-microsoft-prod.deb -rm packages-microsoft-prod.deb -``` - -[!INCLUDE [linux-apt-install-70](includes/linux-install-70-apt.md)] - -## How to install other versions - -[!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)] - -## Troubleshooting - -If you run into issues installing or even running .NET, see [Troubleshooting](linux-ubuntu.md#troubleshooting). - -## Dependencies - -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: - -- libc6 -- libgcc1 -- libgssapi-krb5-2 -- libicu60 -- libssl1.1 -- libstdc++6 -- zlib1g - -[!INCLUDE [linux-ubuntu-deps-example](includes/linux-ubuntu-deps-example.md)] - -[!INCLUDE [linux-libgdiplus-general](includes/linux-libgdiplus-general.md)] - -You can install a recent version of *libgdiplus* by [adding the Mono repository to your system](https://www.mono-project.com/download/stable/#download-lin-ubuntu). - -## Next steps - -- [How to enable TAB completion for the .NET CLI](../tools/enable-tab-autocomplete.md) -- [Tutorial: Create a console application with .NET SDK using Visual Studio Code](../tutorials/with-visual-studio-code.md) diff --git a/docs/core/install/linux-ubuntu-2004.md b/docs/core/install/linux-ubuntu-2004.md deleted file mode 100644 index ce478a9fd4066..0000000000000 --- a/docs/core/install/linux-ubuntu-2004.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Install .NET on Ubuntu 20.04 -description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Ubuntu 20.04. -author: adegeo -ms.author: adegeo -ms.date: 11/14/2023 -ms.custom: linux-related-content ---- - -# Install .NET SDK or .NET Runtime on Ubuntu 20.04 - -This article discusses how to install .NET on Ubuntu 20.04; .NET 8, .NET 7, and .NET 6, are supported. - -[!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 versions - -The following versions of .NET are supported or available for Ubuntu 20.04: - -| Supported .NET versions | Available in Ubuntu feed | [Available in Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | -|-------------------------|--------------------------|-----------------------------------| -| 8.0, 7.0, 6.0 | None | 8.0, 7.0. 6.0, 5.0, 3.1, 2.1 | - -When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version. - -[!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] - -## Add the Microsoft package repository - -[!INCLUDE [linux-prep-intro-apt](includes/linux-prep-intro-apt.md)] - -```bash -wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb -sudo dpkg -i packages-microsoft-prod.deb -rm packages-microsoft-prod.deb -``` - -[!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] - -## How to install other versions - -[!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)] - -## Troubleshooting - -If you run into issues installing or even running .NET, see [Troubleshooting](linux-ubuntu.md#troubleshooting). - -## Dependencies - -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: - -- libc6 -- libgcc-s1 -- libgssapi-krb5-2 -- libicu66 -- libssl1.1 -- libstdc++6 -- zlib1g - -[!INCLUDE [linux-ubuntu-deps-example](includes/linux-ubuntu-deps-example.md)] - -[!INCLUDE [linux-libgdiplus-general](includes/linux-libgdiplus-general.md)] - -You can install a recent version of *libgdiplus* by [adding the Mono repository to your system](https://www.mono-project.com/download/stable/#download-lin-ubuntu). - -## Next steps - -- [How to enable TAB completion for the .NET CLI](../tools/enable-tab-autocomplete.md) -- [Tutorial: Create a console application with .NET SDK using Visual Studio Code](../tutorials/with-visual-studio-code.md) diff --git a/docs/core/install/linux-ubuntu-2204.md b/docs/core/install/linux-ubuntu-2204.md deleted file mode 100644 index 54def5db6e256..0000000000000 --- a/docs/core/install/linux-ubuntu-2204.md +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: Install .NET on Ubuntu 22.04 -description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Ubuntu 22.04. -author: adegeo -ms.author: adegeo -ms.date: 11/14/2023 -ms.custom: linux-related-content ---- - -# Install .NET SDK or .NET Runtime on Ubuntu 22.04 - -This article discusses how to install .NET on Ubuntu 22.04; .NET 8, .NET 7, and .NET 6, are supported. - -[!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)] - -.NET is available in the [Ubuntu packages feed](https://packages.ubuntu.com/), 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). - -## Supported versions - -The following versions of .NET are supported or available for Ubuntu 22.04: - -| Supported .NET versions | Available in Ubuntu feed | [Available in Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | -|-------------------------|--------------------------|-----------------------------------| -| 8.0, 7.0, 6.0 | 7.0, 6.0 | 8.0, 7.0, 6.0, 3.1 | - -[!INCLUDE [linux-ubuntu-feed-sdk-note](includes/linux-ubuntu-feed-sdk-note.md)] - -When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version. - -[!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] - -## Install .NET - -[!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] - -## How to install other versions - -Other versions of .NET aren't supported in the Ubuntu feeds. Instead, use the Microsoft package repository. - -## Troubleshooting - -If you run into issues installing or even running .NET, see [Troubleshooting](linux-ubuntu.md#troubleshooting). - -## Dependencies - -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: - -- libc6 -- libgcc-s1 -- libgssapi-krb5-2 -- libicu70 -- liblttng-ust1 -- libssl3 -- libstdc++6 -- libunwind8 -- zlib1g - -[!INCLUDE [linux-ubuntu-deps-example](includes/linux-ubuntu-deps-example.md)] - -[!INCLUDE [linux-libgdiplus-general](includes/linux-libgdiplus-general.md)] - -You can install a recent version of *libgdiplus* by [adding the Mono repository to your system](https://www.mono-project.com/download/stable/#download-lin-ubuntu). - -## Next steps - -- [How to enable TAB completion for the .NET CLI](../tools/enable-tab-autocomplete.md) -- [Tutorial: Create a console application with .NET SDK using Visual Studio Code](../tutorials/with-visual-studio-code.md) diff --git a/docs/core/install/linux-ubuntu-2210.md b/docs/core/install/linux-ubuntu-2210.md deleted file mode 100644 index 30def52d813ea..0000000000000 --- a/docs/core/install/linux-ubuntu-2210.md +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: Install .NET on Ubuntu 22.10 -description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Ubuntu 22.10. -author: adegeo -ms.author: adegeo -ms.date: 05/24/2023 -ms.custom: linux-related-content ---- - -# Install .NET SDK or .NET Runtime on Ubuntu 22.10 - -This article discusses how to install .NET on Ubuntu 22.10; .NET 6 and .NET 7 are both supported. - -[!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)] - -.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). - -> [!WARNING] -> Don't use both repositories to manage .NET. If you've previously installed .NET from the Ubuntu feed or the Microsoft feed, you'll run into issues using the other feed. .NET is installed to different locations and is resolved differently for both package feeds. It's recommended that you uninstall previously installed versions of .NET and then install with the Microsoft package repository. For more information, see [How to register the Microsoft package repository](linux-ubuntu.md#register-the-microsoft-package-repository). - -## Supported versions - -The following versions of .NET are supported or available for Ubuntu 22.10: - -| Supported .NET versions | Available in Ubuntu feed | [Available in Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | -|-------------------------|--------------------------|-----------------------------------| -| 7.0, 6.0 | 7.0, 6.0 | 7.0, 6.0, 3.1 | - -[!INCLUDE [linux-ubuntu-feed-sdk-note](includes/linux-ubuntu-feed-sdk-note.md)] - -When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version. - -[!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] - -## Install .NET - -[!INCLUDE [linux-apt-install-70](includes/linux-install-70-apt.md)] - -## How to install other versions - -.NET package names are standardized across all Linux distributions. The following table lists the packages: - -[!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)] - -## Troubleshooting - -If you run into issues installing or even running .NET, see [Troubleshooting](linux-ubuntu.md#troubleshooting). - -## Dependencies - -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: - -- libc6 -- libgcc-s1 -- libgssapi-krb5-2 -- libicu71 -- liblttng-ust1 -- libssl3 -- libstdc++6 -- libunwind8 -- zlib1g - -[!INCLUDE [linux-ubuntu-deps-example](includes/linux-ubuntu-deps-example.md)] - -[!INCLUDE [linux-libgdiplus-general](includes/linux-libgdiplus-general.md)] - -You can install a recent version of *libgdiplus* by [adding the Mono repository to your system](https://www.mono-project.com/download/stable/#download-lin-ubuntu). - -## Next steps - -- [How to enable TAB completion for the .NET CLI](../tools/enable-tab-autocomplete.md) -- [Tutorial: Create a console application with .NET SDK using Visual Studio Code](../tutorials/with-visual-studio-code.md) diff --git a/docs/core/install/linux-ubuntu-2304.md b/docs/core/install/linux-ubuntu-2304.md deleted file mode 100644 index ca8a2d1566fcb..0000000000000 --- a/docs/core/install/linux-ubuntu-2304.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Install .NET on Ubuntu 23.04 -description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Ubuntu 23.04. -author: adegeo -ms.author: adegeo -ms.date: 11/14/2023 -ms.custom: linux-related-content ---- - -# Install .NET SDK or .NET Runtime on Ubuntu 23.04 - -This article discusses how to install .NET on Ubuntu 23.04; .NET 8, .NET 7, and .NET 6, are supported. - -[!INCLUDE [linux-intro-sdk-vs-runtime](includes/linux-intro-sdk-vs-runtime.md)] - -[!INCLUDE [linux-install-package-manager-x64-vs-arm-ubuntu](includes/linux-install-package-manager-x64-vs-arm-ubuntu.md)] - -.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). - -## Supported versions - -The following versions of .NET are supported or available for Ubuntu 23.04: - -| Supported .NET versions | Available in Ubuntu feed | [Available in Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | -|-------------------------|--------------------------|-----------------------------------| -| 8.0, 7.0, 6.0 | 7.0, 6.0 | 8.0, 7.0, 6.0 | - -[!INCLUDE [linux-ubuntu-feed-sdk-note](includes/linux-ubuntu-feed-sdk-note.md)] - -When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version. - -[!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] - -## Install .NET - -[!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] - -## How to install other versions - -.NET package names are standardized across all Linux distributions. The following table lists the packages: - -[!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)] - -## Troubleshooting - -If you run into issues installing or even running .NET, see [Troubleshooting](linux-ubuntu.md#troubleshooting). - -## Dependencies - -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: - -- libc6 -- libgcc-s1 -- libgssapi-krb5-2 -- libicu72 -- liblttng-ust1 -- libssl3 -- libstdc++6 -- libunwind8 -- zlib1g - -[!INCLUDE [linux-ubuntu-deps-example](includes/linux-ubuntu-deps-example.md)] - -[!INCLUDE [linux-libgdiplus-general](includes/linux-libgdiplus-general.md)] - -You can install a recent version of *libgdiplus* by [adding the Mono repository to your system](https://www.mono-project.com/download/stable/#download-lin-ubuntu). - -## Next steps - -- [How to enable TAB completion for the .NET CLI](../tools/enable-tab-autocomplete.md) -- [Tutorial: Create a console application with .NET SDK using Visual Studio Code](../tutorials/with-visual-studio-code.md) diff --git a/docs/core/install/linux-ubuntu-2310.md b/docs/core/install/linux-ubuntu-2310.md deleted file mode 100644 index c0e2e76dcc8f2..0000000000000 --- a/docs/core/install/linux-ubuntu-2310.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Install .NET on Ubuntu 23.10 -description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Ubuntu 23.10. -author: adegeo -ms.author: adegeo -ms.date: 11/20/2023 -ms.custom: linux-related-content ---- - -# Install .NET SDK or .NET Runtime on Ubuntu 23.10 - -This article discusses how to install .NET on Ubuntu 23.10; .NET 8, .NET 7, and .NET 6, are supported. - -[!INCLUDE [linux-intro-sdk-vs-runtime](includes/linux-intro-sdk-vs-runtime.md)] - -[!INCLUDE [linux-install-package-manager-x64-vs-arm-ubuntu](includes/linux-install-package-manager-x64-vs-arm-ubuntu.md)] - -.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). - -## Supported versions - -The following versions of .NET are supported or available for Ubuntu 23.10: - -| Supported .NET versions | Available in Ubuntu feed | [Available in Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | -|-------------------------|--------------------------|-----------------------------------| -| 8.0, 7.0, 6.0 | 8.0, 7.0, 6.0 | 8.0, 7.0, 6.0 | - -[!INCLUDE [linux-ubuntu-feed-sdk-note](includes/linux-ubuntu-feed-sdk-note.md)] - -When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version. - -[!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] - -## Install .NET - -[!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] - -## How to install other versions - -.NET package names are standardized across all Linux distributions. The following table lists the packages: - -[!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)] - -## Troubleshooting - -If you run into issues installing or even running .NET, see [Troubleshooting](linux-ubuntu.md#troubleshooting). - -## Dependencies - -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: - -- libc6 -- libgcc-s1 -- libgssapi-krb5-2 -- libicu72 -- liblttng-ust1 -- libssl3 -- libstdc++6 -- libunwind8 -- zlib1g - -[!INCLUDE [linux-ubuntu-deps-example](includes/linux-ubuntu-deps-example.md)] - -[!INCLUDE [linux-libgdiplus-general](includes/linux-libgdiplus-general.md)] - -You can install a recent version of *libgdiplus* by [adding the Mono repository to your system](https://www.mono-project.com/download/stable/#download-lin-ubuntu). - -## Next steps - -- [How to enable TAB completion for the .NET CLI](../tools/enable-tab-autocomplete.md) -- [Tutorial: Create a console application with .NET SDK using Visual Studio Code](../tutorials/with-visual-studio-code.md) diff --git a/docs/core/install/linux-ubuntu-install.md b/docs/core/install/linux-ubuntu-install.md new file mode 100644 index 0000000000000..67f6b7a3ef729 --- /dev/null +++ b/docs/core/install/linux-ubuntu-install.md @@ -0,0 +1,517 @@ +--- +title: Install .NET on Ubuntu +description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Ubuntu +author: adegeo +ms.author: adegeo +ms.date: 03/19/2024 +ms.custom: linux-related-content +zone_pivot_groups: ubuntu-install-set-one +--- + +# Install .NET SDK or .NET Runtime on Ubuntu + +This article discusses how to install .NET on Ubuntu. + +[!INCLUDE [linux-intro-sdk-vs-runtime](includes/linux-intro-sdk-vs-runtime.md)] + +[!INCLUDE [linux-install-package-manager-x64-vs-arm-ubuntu](includes/linux-install-package-manager-x64-vs-arm-ubuntu.md)] + + + +::: zone pivot="os-linux-ubuntu-2404" + +## Ubuntu 24.04 + +[!INCLUDE [linux-ubuntu-package-feed-both](includes/linux-ubuntu-package-feed-both.md)] + +The following versions of .NET are supported or available for Ubuntu 24.04: + +| Supported .NET versions | Available in Ubuntu feed | [Available in Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | +|-------------------------|--------------------------|-----------------------------------| +| 8.0 | 8.0 | None | + + + +When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version. + +# [.NET 8](#tab/dotnet8) + +[!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] + +# [.NET 7](#tab/dotnet7) + +.NET 7 isn't supported on Ubuntu 24.04. + +# [.NET 6](#tab/dotnet6) + +.NET 6 isn't supported on Ubuntu 24.04. + +--- + +## Dependencies + +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: + +- libc6 +- libgcc-s1 +- libicu72 +- liblttng-ust1 +- libssl3 +- libstdc++6 +- libunwind8 +- zlib1g + +[!INCLUDE [linux-ubuntu-deps-example](includes/linux-ubuntu-deps-example.md)] + +[!INCLUDE [linux-libgdiplus-general](includes/linux-libgdiplus-general.md)] + +You can install a recent version of _libgdiplus_ by [adding the Mono repository to your system](https://www.mono-project.com/download/stable/#download-lin-ubuntu). + +::: zone-end + + + +::: zone pivot="os-linux-ubuntu-2310" + +## Ubuntu 23.10 + +[!INCLUDE [linux-ubuntu-package-feed-both](includes/linux-ubuntu-package-feed-both.md)] + +The following versions of .NET are supported or available for Ubuntu 23.10: + +| Supported .NET versions | Available in Ubuntu feed | [Available in Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | +|-------------------------|--------------------------|-----------------------------------| +| 8.0, 7.0, 6.0 | 8.0, 7.0, 6.0 | 8.0, 7.0, 6.0 | + +[!INCLUDE [linux-ubuntu-feed-sdk-note](includes/linux-ubuntu-feed-sdk-note.md)] + +When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version. + +# [.NET 8](#tab/dotnet8) + +[!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] + +# [.NET 7](#tab/dotnet7) + +[!INCLUDE [linux-apt-install-70](includes/linux-install-70-apt.md)] + +# [.NET 6](#tab/dotnet6) + +[!INCLUDE [linux-apt-install-60](includes/linux-install-60-apt.md)] + +--- + +## Dependencies + +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: + +- libc6 +- libgcc-s1 +- libgssapi-krb5-2 +- libicu72 +- liblttng-ust1 +- libssl3 +- libstdc++6 +- libunwind8 +- zlib1g + +[!INCLUDE [linux-ubuntu-deps-example](includes/linux-ubuntu-deps-example.md)] + +[!INCLUDE [linux-libgdiplus-general](includes/linux-libgdiplus-general.md)] + +You can install a recent version of _libgdiplus_ by [adding the Mono repository to your system](https://www.mono-project.com/download/stable/#download-lin-ubuntu). + +::: zone-end + +::: zone pivot="os-linux-ubuntu-2204" + + + +## Ubuntu 22.04 + +[!INCLUDE [linux-ubuntu-package-feed-both](includes/linux-ubuntu-package-feed-both.md)] + +The following versions of .NET are supported or available for Ubuntu 22.04: + +| Supported .NET versions | Available in Ubuntu feed | [Available in Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | +|-------------------------|--------------------------|-----------------------------------| +| 8.0, 7.0, 6.0 | 8.0, 7.0, 6.0 | 8.0, 7.0, 6.0, 3.1 | + +[!INCLUDE [linux-ubuntu-feed-sdk-note](includes/linux-ubuntu-feed-sdk-note.md)] + +When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version. + +# [.NET 8](#tab/dotnet8) + +[!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] + +# [.NET 7](#tab/dotnet7) + +[!INCLUDE [linux-apt-install-70](includes/linux-install-70-apt.md)] + +# [.NET 6](#tab/dotnet6) + +[!INCLUDE [linux-apt-install-60](includes/linux-install-60-apt.md)] + +--- + +## Dependencies + +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: + +- libc6 +- libgcc-s1 +- libgssapi-krb5-2 +- libicu70 +- liblttng-ust1 +- libssl3 +- libstdc++6 +- libunwind8 +- zlib1g + +[!INCLUDE [linux-ubuntu-deps-example](includes/linux-ubuntu-deps-example.md)] + +[!INCLUDE [linux-libgdiplus-general](includes/linux-libgdiplus-general.md)] + +You can install a recent version of _libgdiplus_ by [adding the Mono repository to your system](https://www.mono-project.com/download/stable/#download-lin-ubuntu). + +::: zone-end + + + +::: zone pivot="os-linux-ubuntu-2004" + +## Ubuntu 20.04 + +[!INCLUDE [linux-ubuntu-package-feed-ms](includes/linux-ubuntu-package-feed-ms.md)] + +The following versions of .NET are supported or available for Ubuntu 20.04: + +| Supported .NET versions | Available in Ubuntu feed | [Available in Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | +|-------------------------|--------------------------|-----------------------------------| +| 8.0, 7.0, 6.0 | None | 8.0, 7.0. 6.0, 5.0, 3.1, 2.1 | + +When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version. + +## Add the Microsoft package repository + +[!INCLUDE [linux-prep-intro-apt](includes/linux-prep-intro-apt.md)] + +```bash +wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb +sudo dpkg -i packages-microsoft-prod.deb +rm packages-microsoft-prod.deb +``` + +# [.NET 8](#tab/dotnet8) + +[!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] + +# [.NET 7](#tab/dotnet7) + +[!INCLUDE [linux-apt-install-70](includes/linux-install-70-apt.md)] + +# [.NET 6](#tab/dotnet6) + +[!INCLUDE [linux-apt-install-60](includes/linux-install-60-apt.md)] + +--- + +## Dependencies + +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: + +- libc6 +- libgcc-s1 +- libgssapi-krb5-2 +- libicu66 +- libssl1.1 +- libstdc++6 +- zlib1g + +[!INCLUDE [linux-ubuntu-deps-example](includes/linux-ubuntu-deps-example.md)] + +[!INCLUDE [linux-libgdiplus-general](includes/linux-libgdiplus-general.md)] + +You can install a recent version of _libgdiplus_ by [adding the Mono repository to your system](https://www.mono-project.com/download/stable/#download-lin-ubuntu). + +::: zone-end + + + +::: zone pivot="os-linux-ubuntu-1804" + +## Ubuntu 18.04 + +[!INCLUDE [linux-ubuntu-package-feed-ms](includes/linux-ubuntu-package-feed-ms.md)] + +The following versions of .NET are supported or available for Ubuntu 18.04: + +| Supported .NET versions | Available in Ubuntu feed | [Available in Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | +|-------------------------|--------------------------|-----------------------------------| +| 7.0, 6.0 | None | 7.0. 6.0, 5.0, 3.1, 2.2, 2.1 | + +When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version. + +## Add the Microsoft package repository + +[!INCLUDE [linux-prep-intro-apt](includes/linux-prep-intro-apt.md)] + +```bash +wget https://packages.microsoft.com/config/ubuntu/18.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb +sudo dpkg -i packages-microsoft-prod.deb +rm packages-microsoft-prod.deb +``` + +# [.NET 8](#tab/dotnet8) + +.NET 8 isn't supported on Ubuntu 18.04. + +# [.NET 7](#tab/dotnet7) + +[!INCLUDE [linux-apt-install-70](includes/linux-install-70-apt.md)] + +# [.NET 6](#tab/dotnet6) + +[!INCLUDE [linux-apt-install-60](includes/linux-install-60-apt.md)] + +--- + +## Dependencies + +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: + +- libc6 +- libgcc1 +- libgssapi-krb5-2 +- libicu60 +- libssl1.1 +- libstdc++6 +- zlib1g + +[!INCLUDE [linux-ubuntu-deps-example](includes/linux-ubuntu-deps-example.md)] + +[!INCLUDE [linux-libgdiplus-general](includes/linux-libgdiplus-general.md)] + +You can install a recent version of _libgdiplus_ by [adding the Mono repository to your system](https://www.mono-project.com/download/stable/#download-lin-ubuntu). + +::: zone-end + + + +::: zone pivot="os-linux-ubuntu-1604" + +## Ubuntu 16.04 + +[!INCLUDE [linux-ubuntu-package-feed-ms](includes/linux-ubuntu-package-feed-ms.md)] + +The following versions of .NET are supported or available for Ubuntu 16.04: + +| Supported .NET versions | Available in Ubuntu feed | [Available in Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | +|-------------------------|--------------------------|-----------------------------------| +| 6.0 | None | 6.0, 5.0, 3.1, 3.0, 2.2, 2.1, 2.0 | + +When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version. + +## Add the Microsoft package repository + +[!INCLUDE [linux-prep-intro-apt](includes/linux-prep-intro-apt.md)] + +```bash +wget https://packages.microsoft.com/config/ubuntu/16.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb +sudo dpkg -i packages-microsoft-prod.deb +rm packages-microsoft-prod.deb +``` + +# [.NET 8](#tab/dotnet8) + +.NET 8 isn't supported on Ubuntu 16.04. + +# [.NET 7](#tab/dotnet7) + +.NET 7 isn't supported on Ubuntu 16.04. + +# [.NET 6](#tab/dotnet6) + +[!INCLUDE [linux-apt-install-60](includes/linux-install-60-apt.md)] + +--- + +## Dependencies + +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: + +- libc6 +- libgcc1 +- libgssapi-krb5-2 +- libicu55 +- libssl1.0.0 +- libstdc++6 +- zlib1g + +[!INCLUDE [linux-ubuntu-deps-example](includes/linux-ubuntu-deps-example.md)] + +[!INCLUDE [linux-libgdiplus-general](includes/linux-libgdiplus-general.md)] + +You can install a recent version of _libgdiplus_ by [adding the Mono repository to your system](https://www.mono-project.com/download/stable/#download-lin-ubuntu). + +::: zone-end + + + +::: zone pivot="os-linux-ubuntu-2310,os-linux-ubuntu-2204,os-linux-ubuntu-2004,os-linux-ubuntu-1804,os-linux-ubuntu-1604" + +## Unsupported versions + +[!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] + +## How to install other versions + +.NET package names are standardized across all Linux distributions. The following table lists the packages: + +[!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)] + +::: zone-end + + + +::: zone pivot="os-linux-ubuntu-other" + +## Manual install + +If your Ubuntu version isn't supported, you most likely need to install .NET by manually extracting the binaries, by using the install script. For more information, see [Install .NET on Linux without using a package manager](linux-scripted-manual.md). + + + +## Ubuntu 23.04 + +> [!WARNING] +> This version of Ubuntu is no longer supported. +> +> Running .NET on this version of Ubuntu is no longer supported. + +[!INCLUDE [linux-ubuntu-package-feed-both](includes/linux-ubuntu-package-feed-both.md)] + +The following versions of .NET are supported or available for Ubuntu 23.04: + +| Supported .NET versions | Available in Ubuntu feed | [Available in Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | +|-------------------------|--------------------------|-----------------------------------| +| 8.0, 7.0, 6.0 | 7.0, 6.0 | 8.0, 7.0, 6.0 | + +[!INCLUDE [linux-ubuntu-feed-sdk-note](includes/linux-ubuntu-feed-sdk-note.md)] + +# [.NET 8](#tab/dotnet8) + +[!INCLUDE [linux-ubuntu-80-ms](includes/linux-ubuntu-80-ms.md)] + +[!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] + +# [.NET 7](#tab/dotnet7) + +[!INCLUDE [linux-apt-install-70](includes/linux-install-70-apt.md)] + +# [.NET 6](#tab/dotnet6) + +[!INCLUDE [linux-apt-install-60](includes/linux-install-60-apt.md)] + +--- + +### Dependencies + +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: + +- libc6 +- libgcc-s1 +- libgssapi-krb5-2 +- libicu72 +- liblttng-ust1 +- libssl3 +- libstdc++6 +- libunwind8 +- zlib1g + +[!INCLUDE [linux-ubuntu-deps-example](includes/linux-ubuntu-deps-example.md)] + +[!INCLUDE [linux-libgdiplus-general](includes/linux-libgdiplus-general.md)] + +You can install a recent version of _libgdiplus_ by [adding the Mono repository to your system](https://www.mono-project.com/download/stable/#download-lin-ubuntu). + + + +## Ubuntu 22.10 + +> [!WARNING] +> This version of Ubuntu is no longer supported. +> +> Running .NET on this version of Ubuntu is no longer supported. + +[!INCLUDE [linux-ubuntu-package-feed-both](includes/linux-ubuntu-package-feed-both.md)] + +The following versions of .NET are supported or available for Ubuntu 22.10: + +| Supported .NET versions | Available in Ubuntu feed | [Available in Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | +|-------------------------|--------------------------|-----------------------------------| +| 7.0, 6.0 | 7.0, 6.0 | 7.0, 6.0, 3.1 | + +[!INCLUDE [linux-ubuntu-feed-sdk-note](includes/linux-ubuntu-feed-sdk-note.md)] + +# [.NET 8](#tab/dotnet8) + +.NET 8 isn't supported on Ubuntu 22.10. + +# [.NET 7](#tab/dotnet7) + +[!INCLUDE [linux-apt-install-70](includes/linux-install-70-apt.md)] + +# [.NET 6](#tab/dotnet6) + +[!INCLUDE [linux-apt-install-60](includes/linux-install-60-apt.md)] + +--- + +### Dependencies + +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: + +- libc6 +- libgcc-s1 +- libgssapi-krb5-2 +- libicu71 +- liblttng-ust1 +- libssl3 +- libstdc++6 +- libunwind8 +- zlib1g + +::: zone-end + +[!INCLUDE [linux-ubuntu-deps-example](includes/linux-ubuntu-deps-example.md)] + +[!INCLUDE [linux-libgdiplus-general](includes/linux-libgdiplus-general.md)] + +You can install a recent version of _libgdiplus_ by [adding the Mono repository to your system](https://www.mono-project.com/download/stable/#download-lin-ubuntu). + +## Next steps + +- [How to enable TAB completion for the .NET CLI.](../tools/enable-tab-autocomplete.md) +- [Tutorial: Create a console application with .NET SDK using Visual Studio Code.](../tutorials/with-visual-studio-code.md) diff --git a/docs/core/install/linux-ubuntu.md b/docs/core/install/linux-ubuntu.md index 153fe88e0aaed..e5e86eb8ba786 100644 --- a/docs/core/install/linux-ubuntu.md +++ b/docs/core/install/linux-ubuntu.md @@ -7,7 +7,7 @@ ms.date: 01/24/2024 ms.custom: updateeachrelease, linux-related-content --- -# Install the .NET SDK or the .NET Runtime on Ubuntu +# Overview of .NET on Ubuntu This article describes how to install .NET on Ubuntu. The Microsoft package repository contains every version of .NET that is currently, or was previously, supported on Ubuntu. Starting with Ubuntu 22.04, some versions of .NET are available in the Ubuntu package feed. For more information about available versions, see the [Supported distributions](#supported-distributions) section. @@ -40,10 +40,10 @@ Use the following sections to determine how you should install .NET: Install .NET through the Ubuntu feed. For more information, see the following pages: -- [Install .NET on Ubuntu 22.04](linux-ubuntu-2204.md). -- [Install .NET on Ubuntu 22.10](linux-ubuntu-2210.md). -- [Install .NET on Ubuntu 23.04](linux-ubuntu-2304.md). -- [Install .NET on Ubuntu 23.10](linux-ubuntu-2310.md). +- [Install .NET on Ubuntu 24.04](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2404). +- [Install .NET on Ubuntu 23.10](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2310). +- [Install .NET on Ubuntu 23.04](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2304). +- [Install .NET on Ubuntu 22.04](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2204). [!INCLUDE [linux-ubuntu-feed-sdk-note](includes/linux-ubuntu-feed-sdk-note.md)] @@ -53,9 +53,9 @@ If you're going to install the Microsoft repository to use other Microsoft packa Use the instructions on the version-specific Ubuntu page. -- [20.04 (LTS)](linux-ubuntu-2004.md) -- [18.04 (LTS)](linux-ubuntu-1804.md) -- [16.04 (LTS)](linux-ubuntu-1604.md) +- [20.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2004) +- [18.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-1804) +- [16.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-1604) Review the [Supported distributions](#supported-distributions) section for more information about what versions of .NET are supported for your version of Ubuntu. If you're installing a version that isn't supported, see [Register the Microsoft package repository](#register-the-microsoft-package-repository). @@ -105,15 +105,15 @@ The following table is a list of currently supported .NET releases and the versi -| Ubuntu | Supported .NET versions | Available in Ubuntu feed | [Available in Microsoft feed](#register-the-microsoft-package-repository) | -|-------------------------------------|-------------------------|--------------------------|-----------------------------------| -| [23.10](linux-ubuntu-2310.md) | 8.0, 7.0, 6.0 | 8.0, 7.0, 6.0 | 8.0, 7.0, 6.0 | -| [23.04](linux-ubuntu-2304.md) | 8.0, 7.0, 6.0 | 7.0, 6.0 | 8.0, 7.0, 6.0 | -| [22.10](linux-ubuntu-2210.md) | 7.0, 6.0 | 7.0, 6.0 | 7.0, 6.0, 3.1 | -| [22.04 (LTS)](linux-ubuntu-2204.md) | 8.0, 7.0, 6.0 | 7.0, 6.0 | 8.0, 7.0, 6.0, 3.1 | -| [20.04 (LTS)](linux-ubuntu-2004.md) | 8.0, 7.0, 6.0 | None | 8.0, 7.0. 6.0, 5.0, 3.1, 2.1 | -| [18.04 (LTS)](linux-ubuntu-1804.md) | 7.0, 6.0 | None | 7.0. 6.0, 5.0, 3.1, 2.2, 2.1 | -| [16.04 (LTS)](linux-ubuntu-1604.md) | 6.0 | None | 6.0, 5.0, 3.1, 3.0, 2.2, 2.1, 2.0 | +| Ubuntu | Supported .NET versions | Available in Ubuntu feed | [Available in Microsoft feed](#register-the-microsoft-package-repository) | +|--------------------------------------------------------------------|-------------------------|--------------------------|-----------------------------------| +| [24.04](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2310) | 8.0 | 8.0 | None | +| [23.10](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2310) | 8.0, 7.0, 6.0 | 8.0, 7.0, 6.0 | 8.0, 7.0, 6.0 | +| [23.04](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2304) | 8.0, 7.0, 6.0 | 7.0, 6.0 | 8.0, 7.0, 6.0 | +| [22.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2204) | 8.0, 7.0, 6.0 | 7.0, 6.0 | 8.0, 7.0, 6.0, 3.1 | +| [20.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2004) | 8.0, 7.0, 6.0 | None | 8.0, 7.0. 6.0, 5.0, 3.1, 2.1 | +| [18.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-1804) | 7.0, 6.0 | None | 7.0. 6.0, 5.0, 3.1, 2.2, 2.1 | +| [16.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-1604) | 6.0 | None | 6.0, 5.0, 3.1, 3.0, 2.2, 2.1, 2.0 | When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version. @@ -124,7 +124,7 @@ When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, The Microsoft package repository contains all versions of .NET that were previously, or are currently, [supported with your version of Ubuntu](#supported-distributions). If your version of Ubuntu provides .NET packages, you'll need to deprioritize the Ubuntu packages and use the Microsoft repository. For instructions on how to deprioritize the packages, see [I need a version of .NET that isn't provided by my Linux distribution](linux-package-mixup.md?pivots=os-linux-ubuntu#i-need-a-version-of-net-that-isnt-provided-by-my-linux-distribution). > [!IMPORTANT] -> Package manager installs are only supported on the **x64** architecture. Other architectures, such as **Arm**, must install .NET by some other means, such as with the [installer script](linux-scripted-manual.md#scripted-install) or by [manual installation](linux-scripted-manual.md#manual-install). +> The Microsoft package repository only supports .NET packages that target the **x64** architecture. Other architectures, such as **Arm**, must install .NET by some other means, such as with the [installer script](linux-scripted-manual.md#scripted-install) or by [manual installation](linux-scripted-manual.md#manual-install). Preview releases are **not** available in the Microsoft package repository. For more information, see [Install preview versions](#install-preview-versions). @@ -134,11 +134,11 @@ Preview releases are **not** available in the Microsoft package repository. For [!INCLUDE [linux-prep-intro-apt](includes/linux-prep-intro-apt.md)] ```bash -# Get Ubuntu version -declare repo_version=$(if command -v lsb_release &> /dev/null; then lsb_release -r -s; else grep -oP '(?<=^VERSION_ID=).+' /etc/os-release | tr -d '"'; fi) +# Get OS version info +source /etc/os-release # Download Microsoft signing key and repository -wget https://packages.microsoft.com/config/ubuntu/$repo_version/packages-microsoft-prod.deb -O packages-microsoft-prod.deb +wget https://packages.microsoft.com/config/$ID/$VERSION_ID/packages-microsoft-prod.deb -O packages-microsoft-prod.deb # Install Microsoft signing key and repository sudo dpkg -i packages-microsoft-prod.deb @@ -225,19 +225,15 @@ This section provides information on common errors you might get while using APT > [!NOTE] > This information only applies when .NET is installed from the Microsoft package feed. -[!INCLUDE [package-manager-failed-to-find-deb](includes/package-manager-failed-to-find-deb.md)] +[!INCLUDE [package-manager-failed-to-find-deb-intro](includes/package-manager-failed-to-find-deb-intro.md)] -```bash -sudo apt-get install -y gpg -wget -O - https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor -o microsoft.asc.gpg -sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/ -wget https://packages.microsoft.com/config/ubuntu/{os-version}/prod.list -sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list -sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg -sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list -sudo apt-get update && \ - sudo apt-get install -y {dotnet-package} -``` +If you're using Ubuntu 23.10 or later, try the following commands: + +[!INCLUDE [package-manager-failed-to-find-deb-new](includes/package-manager-failed-to-find-deb-new.md)] + +If you're using an Ubuntu version prior to 23.10, try the following commands: + +[!INCLUDE [package-manager-failed-to-find-deb-classic](includes/package-manager-failed-to-find-deb-classic.md)] #### Failed to fetch @@ -256,13 +252,13 @@ When you install with a package manager, these libraries are installed for you. - libicu66 (for 20.x) - libicu70 (for 22.04) - libicu71 (for 22.10) -- libicu72 (for 23.04) -- liblttng-ust1 (for 22.x) +- libicu72 (for 23.04 or later) +- liblttng-ust1 (for 22.x or later) - libssl1.0.0 (for 16.x) - libssl1.1 (for 18.x, 20.x) -- libssl3 (for 22.x) +- libssl3 (for 22.x or later) - libstdc++6 -- libunwind8 (for 22.x) +- libunwind8 (for 22.x or later) - zlib1g [!INCLUDE [linux-ubuntu-deps-example](includes/linux-ubuntu-deps-example.md)] diff --git a/docs/fundamentals/toc.yml b/docs/fundamentals/toc.yml index 1021a252f5706..1dcca68d0eb29 100644 --- a/docs/fundamentals/toc.yml +++ b/docs/fundamentals/toc.yml @@ -25,20 +25,8 @@ items: items: - name: Overview href: ../core/install/linux-ubuntu.md - - name: "23.10" - href: ../core/install/linux-ubuntu-2310.md - - name: "23.04" - href: ../core/install/linux-ubuntu-2304.md - - name: "22.10" - href: ../core/install/linux-ubuntu-2210.md - - name: "22.04" - href: ../core/install/linux-ubuntu-2204.md - - name: "20.04" - href: ../core/install/linux-ubuntu-2004.md - - name: "18.04" - href: ../core/install/linux-ubuntu-1804.md - - name: "16.04" - href: ../core/install/linux-ubuntu-1604.md + - name: Install + href: ../core/install/linux-ubuntu-install.md - name: Alpine href: ../core/install/linux-alpine.md - name: CentOS diff --git a/docs/zone-pivot-groups.yml b/docs/zone-pivot-groups.yml index d86ac0984914b..cdb76fbac82c5 100644 --- a/docs/zone-pivot-groups.yml +++ b/docs/zone-pivot-groups.yml @@ -112,6 +112,24 @@ groups: title: C# and Visual Basic - id: lang-fsharp title: F# +- id: ubuntu-install-set-one + title: Ubuntu Version + prompt: Choose the Ubuntu distribution version + pivots: + - id: os-linux-ubuntu-2404 + title: "24.04" + - id: os-linux-ubuntu-2310 + title: "23.10" + - id: os-linux-ubuntu-2204 + title: "22.04" + - id: os-linux-ubuntu-2004 + title: "20.04" + - id: os-linux-ubuntu-1804 + title: "18.04" + - id: os-linux-ubuntu-1604 + title: "16.04" + - id: os-linux-ubuntu-other + title: "Other" - id: openai-library title: OpenAI Library prompt: Choose a library for OpenAI