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
28 changes: 28 additions & 0 deletions docs/core/install/includes/linux-install-60-apk.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
---
author: adegeo
ms.author: adegeo
ms.date: 11/22/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 apk add dotnet6-sdk
```

### 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 install the ASP.NET Core Runtime, which is the most compatible runtime for .NET. In your terminal, run the following command:

```bash
sudo apk add aspnetcore6-runtime
```

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

```bash
sudo apk add dotnet6-runtime
```
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
28 changes: 28 additions & 0 deletions docs/core/install/includes/linux-install-70-apk.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
---
author: adegeo
ms.author: adegeo
ms.date: 11/22/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 apk add dotnet7-sdk
```

### 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 apk add aspnetcore7-runtime
```

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

```bash
sudo apk add dotnet7-runtime
```
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
```
60 changes: 40 additions & 20 deletions docs/core/install/linux-alpine.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,43 +3,63 @@ 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/22/2022
---

# Install the .NET SDK or the .NET Runtime on Alpine

This article describes how to install .NET on Alpine. When an Alpine version falls out of support, .NET is no longer supported with that version. However, these instructions may help you to get .NET running on those versions, even though it isn't supported.
.NET is supported on Alpine and this article describes how to install .NET on Alpine. When an Alpine version falls out of support, .NET is no longer supported with that version.

[!INCLUDE [linux-intro-sdk-vs-runtime](includes/linux-intro-sdk-vs-runtime.md)]

## Install
The Alpine package manager supports installing some versions of .NET. If the .NET package is unavailable, you'll need to install .NET in one of the following alternative ways:

Installers aren't available for Alpine Linux. You must install .NET in one of the following ways:
- [Install with Snap.](linux-snap.md)
- [Use the .NET install script.](linux-scripted-manual.md#scripted-install)
- [Download and install .NET manually.](linux-scripted-manual.md#manual-install)

- [Scripted install with _install-dotnet.sh_](linux-scripted-manual.md#scripted-install)
- [Manual binary extraction](linux-scripted-manual.md#manual-install)
## Install .NET 7

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

## Install .NET 6

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

## Supported distributions

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.17 | 7, 6 |
| 3.16 | 7, 6, 3.1 |
| 3.15 | 7, 6, 3.1 |
| 3.14 | 6, 3.1 |

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

## Supported architectures

| Architecture | .NET 6 | .NET 7 |
|------------------|---------|---------|
| x86_64 | ✔️ 3.16 | ✔️ 3.17 |
| x86 | ❌ | ❌ |
| aarch64 | ✔️ 3.16 | ✔️ 3.17 |
| armv7 | ✔️ 3.16 | ✔️ 3.17 |
| armhf | ❌ | ❌ |
| s390x | ✔️ 3.17 | ❌ |
| ppc64le | ❌ | ❌ |
| riscv64 | ❌ | ❌ |

## Install preview versions

[!INCLUDE [preview installs don't support package managers](./includes/linux-install-previews.md)]

## Remove preview versions

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

## Dependencies

.NET on Alpine Linux requires the following dependencies installed:
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
Loading