Skip to content

Commit

Permalink
Linux installer updates (#21946)
Browse files Browse the repository at this point in the history
* Create snap/manual articles

* Update manual install with deps

* Update alpine with links to manual

* Update other linux distros

* TOC test

* Revert "TOC test"

This reverts commit c10cd62.

* Minor toc change

* Alter fedora structure

* slight restructure

* Adjust table

* Change package manager warning

* Minor

* clarify fedora 32/33

* promote install inst

* Move pieces around

* Fix warnings

* Update some links

* remove note about .NET 5 under the 3.1

* acro

* update dates

* update date

* Update date
  • Loading branch information
adegeo authored Jan 6, 2021
1 parent 4cb0a9e commit d2f5809
Show file tree
Hide file tree
Showing 16 changed files with 385 additions and 298 deletions.
46 changes: 0 additions & 46 deletions docs/core/install/includes/linux-install-manual.md

This file was deleted.

Original file line number Diff line number Diff line change
@@ -1,3 +1,9 @@

> [!IMPORTANT]
> Package manager installs are only supported on the **x64** architecture. Other architectures, such as **ARM**, must manually install .NET. For more information, see the [manual install section](#manual-install).
> 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 Snap, an installer script, or through a manual binary installation.
For more information on installing .NET without a package manager, see one of the following articles:

- [Install the .NET SDK or the .NET Runtime with Snap.](../linux-snap.md)
- [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)
22 changes: 0 additions & 22 deletions docs/core/install/includes/linux-install-scripted.md

This file was deleted.

19 changes: 9 additions & 10 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 - .NET
description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Alpine.
author: adegeo
ms.author: adegeo
ms.date: 11/10/2020
ms.date: 01/06/2021
---

# Install the .NET SDK or the .NET Runtime on Alpine
Expand All @@ -12,7 +12,13 @@ This article describes how to install .NET on Alpine. When an Alpine version fal

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

There are no installers for Alpine. You must either use the [install script](#scripted-install) or follow the [manual install](#manual-install) instructions.
## Install

Installers aren't available for Alpine Linux. You must install .NET in one of the following ways:

- [Snap package](linux-snap.md)
- [Scripted install with _install-dotnet.sh_](linux-scripted-manual.md#scripted-install)
- [Manual binary extraction](linux-scripted-manual.md#manual-install)

## Supported distributions

Expand Down Expand Up @@ -49,14 +55,7 @@ The following versions of .NET are no longer supported. The downloads for these
- libstdc++
- zlib

## Scripted install

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

## Manual install

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

## 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)
23 changes: 6 additions & 17 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 - .NET
description: Demonstrates the various ways to install .NET SDK and .NET Runtime on CentOS.
author: adegeo
ms.author: adegeo
ms.date: 11/10/2020
ms.date: 01/06/2021
---

# Install the .NET SDK or the .NET Runtime on CentOS
Expand Down Expand Up @@ -39,10 +39,6 @@ The following versions of .NET are no longer supported. The downloads for these

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

## How to install other versions

[!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)]

## CentOS 8 ✔️

.NET 5.0 is available in the default package repositories for CentOS 8.
Expand All @@ -59,6 +55,10 @@ sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-

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

## How to install other versions

[!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)]

## Troubleshoot the package manager

This section provides information on common errors you may get while using the package manager to install .NET.
Expand All @@ -71,22 +71,11 @@ This section provides information on common errors you may get while using the p

[!INCLUDE [package-manager-failed-to-fetch-rpm](includes/package-manager-failed-to-fetch-rpm.md)]

## Snap

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

## Dependencies

[!INCLUDE [linux-rpm-install-dependencies](includes/linux-rpm-install-dependencies.md)]

## Scripted install

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

## Manual install

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

## 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)
25 changes: 7 additions & 18 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 - .NET
description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Debian.
author: adegeo
ms.author: adegeo
ms.date: 11/10/2020
ms.date: 01/06/2021
---

# Install the .NET SDK or the .NET Runtime on Debian
Expand Down Expand Up @@ -38,10 +38,6 @@ The following versions of .NET are no longer supported. The downloads for these

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

## How to install other versions

[!INCLUDE [hack-pkgname](./includes/package-manager-heading-hack-pkgname.md)]

## Debian 10 ✔️

[!INCLUDE [linux-prep-intro-apt](includes/linux-prep-intro-apt.md)]
Expand Down Expand Up @@ -85,7 +81,11 @@ sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list

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

## APT update SDK or runtime
## How to install other versions

[!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)]

## Use APT to update .NET

When a new patch release is available for .NET, you can simply upgrade it through APT with the following commands:

Expand Down Expand Up @@ -124,10 +124,6 @@ sudo apt-get update; \

[!INCLUDE [package-manager-failed-to-fetch-deb](includes/package-manager-failed-to-fetch-deb.md)]

## Snap

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

## Dependencies

When you install with a package manager, these libraries are installed for you. But, if you manually install .NET Core or you publish a self-contained app, you'll need to make sure these libraries are installed:
Expand All @@ -151,14 +147,7 @@ For .NET Core apps that use the *System.Drawing.Common* assembly, you also need
> [!WARNING]
> You can install a recent version of *libgdiplus* by adding the Mono repository to your system. For more information, see <https://www.mono-project.com/download/stable/>.
## Scripted install

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

## Manual install

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

## 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)
Loading

0 comments on commit d2f5809

Please sign in to comment.