Skip to content
New issue

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

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

Already on GitHub? Sign in to your account

Updates for linux install instructions #32596

Merged
merged 13 commits into from
Nov 28, 2022
4 changes: 2 additions & 2 deletions docs/core/install/includes/linux-install-60-apt.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ sudo apt-get update && \
```

> [!IMPORTANT]
> If you receive an error message similar to **Unable to locate package dotnet-sdk-6.0**, see the [APT troubleshooting](#apt-troubleshooting) section.
> If you receive an error message similar to **Unable to locate package dotnet-sdk-6.0**, see the [troubleshooting](#troubleshooting) section.

### Install the runtime

Expand All @@ -27,7 +27,7 @@ sudo apt-get update && \
```

> [!IMPORTANT]
> If you receive an error message similar to **Unable to locate package aspnetcore-runtime-6.0**, see the [APT troubleshooting](#apt-troubleshooting) section.
> 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`:

Expand Down
36 changes: 36 additions & 0 deletions docs/core/install/includes/linux-install-70-apt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
---
author: adegeo
ms.author: adegeo
ms.date: 11/15/2022
ms.topic: include
---

### Install the SDK

The .NET SDK allows you to develop apps with .NET. If you install the .NET SDK, you don't need to install the corresponding runtime. To install the .NET SDK, run the following commands:

```bash
sudo apt-get update && \
sudo apt-get install -y dotnet-sdk-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:

```bash
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
sudo apt-get install -y dotnet-runtime-7.0
```
28 changes: 28 additions & 0 deletions docs/core/install/includes/linux-install-70-dnf.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
---
author: adegeo
ms.author: adegeo
ms.date: 11/15/2022
ms.topic: include
---

### Install the SDK
adegeo marked this conversation as resolved.
Show resolved Hide resolved

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 command:

```bash
sudo dnf install dotnet-sdk-7.0
```

### 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 command:

```bash
sudo dnf install aspnetcore-runtime-7.0
```

As an alternative to the ASP.NET Core Runtime, you can install the .NET Runtime, which doesn't include ASP.NET Core support: replace `aspnetcore-runtime-7.0` in the previous command with `dotnet-runtime-7.0`:

```bash
sudo dnf install dotnet-runtime-7.0
```
28 changes: 28 additions & 0 deletions docs/core/install/includes/linux-install-70-yum.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
---
author: adegeo
ms.author: adegeo
ms.date: 11/15/2022
ms.topic: include
---

### 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 command:

```bash
sudo yum install dotnet-sdk-7.0
```

### 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 command:

```bash
sudo yum install aspnetcore-runtime-7.0
```

As an alternative to the ASP.NET Core Runtime, you can install the .NET Runtime, which doesn't include ASP.NET Core support: replace `aspnetcore-runtime-7.0` in the previous command with `dotnet-runtime-7.0`:

```bash
sudo yum install dotnet-runtime-7.0
```
28 changes: 28 additions & 0 deletions docs/core/install/includes/linux-install-70-zyp.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
---
author: adegeo
ms.author: adegeo
ms.date: 11/15/2022
ms.topic: include
---

### 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 command:

```bash
sudo zypper install dotnet-sdk-7.0
```

### 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 command:

```bash
sudo zypper install aspnetcore-runtime-7.0
```

As an alternative to the ASP.NET Core Runtime, you can install the .NET Runtime, which doesn't include ASP.NET Core support: replace `aspnetcore-runtime-7.0` in the previous command with `dotnet-runtime-7.0`:

```bash
sudo zypper install dotnet-runtime-7.0
```
21 changes: 6 additions & 15 deletions docs/core/install/linux-alpine.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Install .NET on Alpine
description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Alpine.
author: adegeo
ms.author: adegeo
ms.date: 10/26/2021
ms.date: 11/15/2022
---

# Install the .NET SDK or the .NET Runtime on Alpine
Expand All @@ -23,20 +23,11 @@ Installers aren't available for Alpine Linux. You must install .NET in one of th

adegeo marked this conversation as resolved.
Show resolved Hide resolved
The following table is a list of currently supported .NET releases and the versions of Alpine they're supported on. These versions remain supported until either the version of [.NET reaches end-of-support](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) or the version of [Alpine reaches end-of-life](https://alpinelinux.org/releases/).

- A ✔️ indicates that the version of Alpine or .NET is still supported.
- A ❌ indicates that the version of Alpine or .NET isn't supported on that Alpine release.
- When both a version of Alpine and a version of .NET have ✔️, that OS and .NET combination is supported.

| Alpine | .NET Core 3.1 | .NET 6 |
|---------|---------------|-----------|
| ✔️ 3.15 | ✔️ 3.1 | ✔️ 6.0 |
| ✔️ 3.14 | ✔️ 3.1 | ✔️ 6.0 |
| ✔️ 3.13 | ✔️ 3.1 | ✔️ 6.0 |
| ✔️ 3.12 | ✔️ 3.1 | ✔️ 6.0 |
| ❌ 3.11 | ✔️ 3.1 | ❌ 6.0 |
| ❌ 3.10 | ✔️ 3.1 | ❌ 6.0 |
| ❌ 3.9 | ✔️ 3.1 | ❌ 6.0 |
| ❌ 3.8 | ✔️ 3.1 | ❌ 6.0 |
| Alpine | .NET |
|--------|-----------|
| 3.15 | 7, 6, 3.1 |
| 3.14 | 6, 3.1 |
| 3.13 | 6, 3.1 |

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

Expand Down
28 changes: 7 additions & 21 deletions docs/core/install/linux-centos.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Install .NET on CentOS
description: Demonstrates the various ways to install .NET SDK and .NET Runtime on CentOS.
author: adegeo
ms.author: adegeo
ms.date: 03/21/2022
ms.date: 11/15/2022
---

# Install the .NET SDK or the .NET Runtime on CentOS
Expand All @@ -18,17 +18,12 @@ ms.date: 03/21/2022

The following table is a list of currently supported .NET releases on both CentOS 7 and CentOS 8. 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 CentOS is no longer supported.

- A ✔️ indicates that the version of CentOS or .NET is still supported.
- A ❌ indicates that the version of CentOS or .NET isn't supported on that CentOS release.
- When both a version of CentOS and a version of .NET have ✔️, that OS and .NET combination is supported.

| CentOS | .NET Core 3.1 | .NET 6 |
|--------------------------|---------------|----------------|
| ✔️ [7](#centos-7-) | ✔️ 3.1 | ✔️ 6.0 |
| ❌ [8](#centos-8-)\* | ✔️ 3.1 | ❌ 6.0 |
| CentOS | .NET |
|---------|-----------|
| 7 | 7, 6, 3.1 |

> [!WARNING]
> \*CentOS 8 reached an early End Of Life (EOL) on December 31st, 2021. For more information, see the official [CentOS Linux EOL page](https://www.centos.org/centos-linux-eol/). Because of this, .NET 6 won't be supported on CentOS Linux 8.
> \*CentOS 8 reached an early End Of Life (EOL) on December 31st, 2021. For more information, see the official [CentOS Linux EOL page](https://www.centos.org/centos-linux-eol/). Because of this, .NET 6 and later versions won't be supported on CentOS Linux 8.

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

Expand All @@ -42,24 +37,15 @@ The following table is a list of currently supported .NET releases on both CentO

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

## CentOS 7 ✔️
## CentOS 7

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

```bash
sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
```

[!INCLUDE [linux-yum-install-60](includes/linux-install-60-yum.md)]

## CentOS 8 ✔️

> [!WARNING]
> \*CentOS 8 will reach an early End Of Life (EOL) on December 31st, 2021. For more information, see the official [CentOS Linux EOL page](https://www.centos.org/centos-linux-eol/). Because of this, .NET 6 won't be supported on CentOS Linux 8.

.NET 5 is available in the default package repositories for CentOS 8.

[!INCLUDE [linux-dnf-install-50](includes/linux-install-50-dnf.md)]
[!INCLUDE [linux-yum-install-70](includes/linux-install-70-yum.md)]

## How to install other versions

Expand Down
58 changes: 10 additions & 48 deletions docs/core/install/linux-debian.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Install .NET on Debian
description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Debian.
author: adegeo
ms.author: adegeo
ms.date: 03/25/2022
ms.date: 11/15/2022
---

# Install the .NET SDK or the .NET Runtime on Debian
Expand All @@ -18,16 +18,10 @@ This article describes how to install .NET on Debian. When a Debian version fall

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).

- A ✔️ indicates that the version of Debian or .NET is still supported.
- A ❌ indicates that the version of Debian or .NET isn't supported on that Debian release.
- When both a version of Debian and a version of .NET have ✔️, that OS and .NET combination is supported.

| Debian | .NET Core 3.1 | .NET 6 |
|--------------------------|---------------|----------|
| ✔️ [11](#debian-11-) | ✔️ 3.1 | ✔️ 6.0 |
| ✔️ [10](#debian-10-) | ✔️ 3.1 | ✔️ 6.0 |
| ✔️ [9](#debian-9-) | ✔️ 3.1 | ✔️ 6.0 |
| ❌ [8](#debian-8-) | ❌ 3.1 | ❌ 6.0 |
| Debian | .NET |
|---------|-----------|
| 11 | 7, 6, 3.1 |
| 10 | 7, 6, 3.1 |

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

Expand All @@ -39,7 +33,7 @@ The following table is a list of currently supported .NET releases and the versi

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

## Debian 11 ✔️
## Debian 11

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

Expand All @@ -49,9 +43,9 @@ sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb
```

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

## Debian 10 ✔️
## Debian 10

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

Expand All @@ -61,39 +55,7 @@ sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb
```

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

## Debian 9 ✔️

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

```bash
wget -O - https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/
wget https://packages.microsoft.com/config/debian/9/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
```

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

## Debian 8 ❌

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

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

```bash
wget -O - https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/
wget https://packages.microsoft.com/config/debian/8/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
```

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

## How to install other versions

Expand All @@ -110,7 +72,7 @@ sudo apt-get upgrade

If you've upgraded your Linux distribution since installing .NET, you may need to reconfigure the Microsoft package repository. Run the installation instructions for your current distribution version to upgrade to the appropriate package repository for .NET updates.

## APT troubleshooting
## Troubleshooting

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

Expand Down
30 changes: 15 additions & 15 deletions docs/core/install/linux-fedora.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Install .NET on Fedora
description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Fedora.
author: adegeo
ms.author: adegeo
ms.date: 08/07/2022
ms.date: 11/15/2022
---

# Install the .NET SDK or the .NET Runtime on Fedora
Expand All @@ -18,28 +18,28 @@ For more information on installing .NET without a package manager, see one of th
- [Install the .NET SDK or the .NET Runtime with a script.](linux-scripted-manual.md#scripted-install)
- [Install the .NET SDK or the .NET Runtime manually.](linux-scripted-manual.md#manual-install)

## Install .NET 6
## Supported distributions

[!INCLUDE [linux-dnf-install-60](includes/linux-install-60-dnf.md)]
The following table is a list of currently supported .NET releases and the versions of Fedora 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 [Fedora reaches end-of-life](https://fedoraproject.org/wiki/End_of_life).

## Install .NET Core 3.1
| Fedora | .NET |
|--------|-----------|
| 37 | 6 |
| 36 | 6, 3.1 |
| 35 | 6, 3.1 |

[!INCLUDE [linux-dnf-install-31](includes/linux-install-31-dnf.md)]
> [!IMPORTANT]
> .NET 7 isn't yet ready for Fedora. This article will be updated when it's available.

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

The following table is a list of currently supported .NET releases and the versions of Fedora 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 [Fedora reaches end-of-life](https://fedoraproject.org/wiki/End_of_life).
## Install .NET 6

- A ✔️ indicates that the version of Fedora or .NET is still supported.
- A ❌ indicates that the version of Fedora or .NET isn't supported on that Fedora release.
- When both a version of Fedora and a version of .NET have ✔️, that OS and .NET combination is supported.
[!INCLUDE [linux-dnf-install-60](includes/linux-install-60-dnf.md)]

| .NET Version | Fedora 36 ✔️ | 35 ✔️ | 34 ❌ | 33 ❌ | 32 ❌ | 31 ❌ | 30 ❌ | 29 ❌ |
| ------------ | ---------: | --: | --: | --: | --: | --: | --: | --: |
| .NET 6 | ✔️ | ✔️ | ✔️ | ❌ | ❌ | ❌ |❌ |❌ |
| .NET Core 3.1 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |✔️ |✔️ |
## Install .NET Core 3.1

[!INCLUDE [versions-not-supported](includes/versions-not-supported.md)]
[!INCLUDE [linux-dnf-install-31](includes/linux-install-31-dnf.md)]

## Install preview versions

Expand Down
Loading