Skip to content

Add Alpine Linux installer page #18912

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

Merged
merged 4 commits into from
Jun 12, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions docs/core/install/includes/linux-install-scripted.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@

The [dotnet-install scripts](../../tools/dotnet-install-script.md) are used for automation and non-admin installs of the **SDK**. You can download the script from <https://dot.net/v1/dotnet-install.sh>.
The [dotnet-install scripts](../../tools/dotnet-install-script.md) are used for automation and non-admin installs of the **SDK** and **Runtime**. You can download the script from <https://dot.net/v1/dotnet-install.sh>.

The script defaults to installing the latest [long term support (LTS)](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) version, which is .NET Core 3.1. To install the current release, which may not be an (LTS) version, use the `-c Current` parameter.
The script defaults to installing the latest SDK [long term support (LTS)](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) version, which is .NET Core 3.1. To install the current release, which may not be an (LTS) version, use the `-c Current` parameter.

```bash
./dotnet-install.sh -c Current
Expand All @@ -10,7 +10,7 @@ The script defaults to installing the latest [long term support (LTS)](https://d
To install .NET Core Runtime instead of the SDK, use the `--runtime` parameter.

```bash
./dotnet-install.sh -c Current --runtime
./dotnet-install.sh -c Current --runtime aspnetcore
```

You can install a specific version by altering the `-c` parameter to indicate the specific version. The following command installs .NET Core SDK 3.1.
Expand Down
63 changes: 63 additions & 0 deletions docs/core/install/linux-alpine.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
---
title: Install .NET Core on Alpine - .NET Core
description: Demonstrates the various ways to install .NET Core SDK and .NET Core Runtime on Alpine.
author: thraka
ms.author: adegeo
ms.date: 06/04/2020
---

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

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

[!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.

## Supported distributions

The following table is a list of currently supported .NET Core releases and the versions of Alpine they're supported on. These versions remain supported until either the version of [.NET Core reaches end-of-support](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) or the version of [Alpine reaches end-of-life](https://wiki.alpinelinux.org/wiki/Alpine_Linux:Releases).

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

| Alpine | .NET Core 2.1 | .NET Core 3.1 | .NET 5 Preview |
|--------------------------|---------------|---------------|----------------|
| ✔️ 3.12 | ✔️ 2.1 | ✔️ 3.1 | ✔️ 5.0 Preview |
| ✔️ 3.11 | ✔️ 2.1 | ✔️ 3.1 | ✔️ 5.0 Preview |
| ✔️ 3.10 | ✔️ 2.1 | ✔️ 3.1 | ✔️ 5.0 Preview |
| ✔️ 3.9 | ✔️ 2.1 | ✔️ 3.1 | ✔️ 5.0 Preview |
| ❌ 3.8 | ✔️ 2.1 | ❌ 3.1 | ❌ 5.0 Preview |

The following versions of .NET Core are no longer supported. The downloads for these still remain published:

- 3.0
- 2.2
- 2.0

## Dependencies

.NET Core on Alpine Linux requires the following dependencies installed:

- icu-libs
- krb5-libs
- libintl
- libssl1.1 (Alpine v3.9 or greater)
- libssl1.0 (Alpine v3.8)
- libstdc++
- lttng-ust
- numactl (optional)
- 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

- [Tutorial: Create a console application with .NET Core SDK using Visual Studio Code](../tutorials/with-visual-studio-code.md)
4 changes: 0 additions & 4 deletions docs/core/install/linux-sles.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,10 +71,6 @@ 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-install-dependencies](includes/linux-install-dependencies.md)]
Expand Down
20 changes: 20 additions & 0 deletions docs/core/install/linux.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,26 @@ The following versions of .NET Core are ❌ no longer supported. The downloads f

These unsupported versions aren't detailed in the sections below and your mileage may vary if you try to install them.

## Alpine

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

The following table is a list of currently supported .NET Core releases and the versions of Alpine they're supported on. These versions remain supported until either the version of [.NET Core reaches end-of-support](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) or the version of [Alpine reaches end-of-life](https://wiki.alpinelinux.org/wiki/Alpine_Linux:Releases).

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

| Alpine | .NET Core 2.1 | .NET Core 3.1 | .NET 5 Preview |
|-----------------------------|---------------|---------------|----------------|
| ✔️ [3.12](linux-alpine.md) | ✔️ 2.1 | ✔️ 3.1 | ✔️ 5.0 Preview |
| ✔️ [3.11](linux-alpine.md) | ✔️ 2.1 | ✔️ 3.1 | ✔️ 5.0 Preview |
| ✔️ [3.10](linux-alpine.md) | ✔️ 2.1 | ✔️ 3.1 | ✔️ 5.0 Preview |
| ✔️ [3.9](linux-alpine.md) | ✔️ 2.1 | ✔️ 3.1 | ✔️ 5.0 Preview |
| ❌ [3.8](linux-alpine.md) | ✔️ 2.1 | ❌ 3.1 | ❌ 5.0 Preview |

For more information, see [Install .NET Core on Alpine](linux-alpine.md).

## CentOS

CentOS 7 uses Yum as a package manager and CentOS 8 uses DNF.
Expand Down
2 changes: 2 additions & 0 deletions docs/core/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,8 @@ items:
href: install/linux.md
- name: Ubuntu
href: install/linux-ubuntu.md
- name: Alpine
href: install/linux-alpine.md
- name: CentOS
href: install/linux-centos.md
- name: Debian
Expand Down