Skip to content
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
33 changes: 33 additions & 0 deletions docs/core/install/includes/linux-install-100-apk.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
---
author: adegeo
ms.author: adegeo
ms.date: 11/07/2025
ms.topic: include
ms.custom: linux-related-content
---

### 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 dotnet10-sdk
```

To learn how to use the .NET CLI, see [.NET CLI overview](../../tools/index.md).

### 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 aspnetcore10-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 `aspnetcore10-runtime` in the previous command with `dotnet10-runtime`:

```bash
sudo apk add dotnet10-runtime
```

To learn how to use the .NET CLI, see [.NET CLI overview](../../tools/index.md).
35 changes: 35 additions & 0 deletions docs/core/install/includes/linux-install-100-apt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
---
author: adegeo
ms.author: adegeo
ms.date: 11/07/2025
ms.topic: include
ms.custom: linux-related-content
---

### 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-10.0
```

To learn how to use the .NET CLI, see [.NET CLI overview](../../tools/index.md).

### 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-10.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-10.0` in the previous command with `dotnet-runtime-10.0`:

```bash
sudo apt-get install -y dotnet-runtime-10.0
```

To learn how to use the .NET CLI, see [.NET CLI overview](../../tools/index.md).
33 changes: 33 additions & 0 deletions docs/core/install/includes/linux-install-100-dnf.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
---
author: adegeo
ms.author: adegeo
ms.date: 11/07/2025
ms.topic: include
ms.custom: linux-related-content
---

### 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 dnf install dotnet-sdk-10.0
```

To learn how to use the .NET CLI, see [.NET CLI overview](../../tools/index.md).

### 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-10.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-10.0` in the previous command with `dotnet-runtime-10.0`:

```bash
sudo dnf install dotnet-runtime-10.0
```

To learn how to use the .NET CLI, see [.NET CLI overview](../../tools/index.md).
33 changes: 33 additions & 0 deletions docs/core/install/includes/linux-install-100-zyp.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
---
author: adegeo
ms.author: adegeo
ms.date: 11/07/2025
ms.topic: include
ms.custom: linux-related-content
---

### 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-10.0
```

To learn how to use the .NET CLI, see [.NET CLI overview](../../tools/index.md).

### 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-10.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-10.0` in the previous command with `dotnet-runtime-10.0`:

```bash
sudo zypper install dotnet-runtime-10.0
```

To learn how to use the .NET CLI, see [.NET CLI overview](../../tools/index.md).
4 changes: 2 additions & 2 deletions docs/core/install/includes/linux-release-wait.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
author: adegeo
ms.author: adegeo
ms.date: 11/11/2024
ms.date: 11/06/2025
ms.topic: include
ms.custom: linux-related-content
---

> [!IMPORTANT]
> .NET 9 was released on November 12, 2024. It may take time for the packages to appear in the package manager feeds or for your specific Linux distribution to include it.
> .NET 10 was released on November 11, 2025. It may take time for the packages to appear in the package manager feeds or for your specific Linux distribution to include it.
24 changes: 0 additions & 24 deletions docs/core/install/includes/linux-rpm-install-dependencies.md

This file was deleted.

58 changes: 0 additions & 58 deletions docs/core/install/includes/verify-download-windows.md

This file was deleted.

2 changes: 1 addition & 1 deletion docs/core/install/includes/versions-not-supported.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
author: adegeo
ms.author: adegeo
ms.date: 11/11/2024
ms.date: 11/06/2025
ms.topic: include
---

Expand Down
2 changes: 1 addition & 1 deletion docs/core/install/index.yml
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ metadata:
title: Install .NET on Windows, Linux, and macOS
description: Learn where to download and install .NET on Windows, Linux, and macOS. Discover the dependencies required to develop, deploy, and run .NET apps.
ms.topic: landing-page
ms.date: 01/26/2023
ms.date: 11/08/2025

# linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | sample | tutorial | video | whats-new

Expand Down
46 changes: 26 additions & 20 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: Learn about which versions of .NET SDK and .NET Runtime are supported, and how to install .NET on Alpine.
author: adegeo
ms.author: adegeo
ms.date: 12/13/2024
ms.date: 11/07/2025
ms.custom: linux-related-content
---

Expand All @@ -13,6 +13,8 @@ ms.custom: linux-related-content

If you're using Docker, consider using [official .NET Docker images](../docker/introduction.md#net-images) instead of installing .NET yourself.

[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]

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

## Supported distributions
Expand All @@ -21,18 +23,21 @@ The following table is a list of currently supported .NET releases and the versi

| Alpine | Supported Version | Available in Package Manager |
|--------|-------------------|------------------------------|
| 3.22 | 10.0, 9.0, 8.0 | 9.0, 8.0 |
| 3.21 | 9.0, 8.0 | 9.0, 8.0 |
| 3.20 | 9.0, 8.0 | 8.0, 6.0 |
| 3.19 | 9.0, 8.0 | 7.0, 6.0 |
| 3.18 | 8.0 | 7.0, 6.0 |

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

## Install .NET

# [.NET 9](#tab/dotnet9)
# [.NET 10](#tab/dotnet10)

[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]

**Not supported on Alpine 3.18.**
[!INCLUDE [linux-apk-install-100](includes/linux-install-100-apk.md)]

# [.NET 9](#tab/dotnet9)

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

Expand All @@ -46,16 +51,16 @@ The following table is a list of currently supported .NET releases and the versi

The following table is a list of currently supported .NET releases and the architecture 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 architecture of [Alpine is supported#](https://alpinelinux.org/releases/). Note that only `x86_64`, `armv7`, `aarch64` is officially supported by Microsoft. Other architectures are supported by the distribution maintainers, and can be installed using the `apk` package manager, if a package is available for that architecture.

| Architecture | .NET 9 | .NET 8 |
|--------------|------------------------|------------------------|
| x86_64 | 3.19, 3.20, 3.21 | 3.18, 3.19, 3.20, 3.21 |
| x86 | None | None |
| aarch64 | 3.19, 3.20, 3.21 | 3.18, 3.19, 3.20, 3.21 |
| armv7 | 3.19, 3.20, 3.21 | 3.18, 3.19, 3.20, 3.21 |
| armhf | None | None |
| s390x | None | None |
| ppc64le | None | None |
| riscv64 | None | None |
| Architecture | .NET 10 | .NET 9 | .NET 8 |
|--------------|----------|-------------------|------------------------|
| x86_64 | 3.22 | 3.20, 3.21, 3.22 | 3.20, 3.21, 3.22 |
| x86 | None | None | None |
| aarch64 | 3.22 | 3.20, 3.21, 3.22 | 3.20, 3.21, 3.22 |
| armv7 | 3.22 | 3.20, 3.21, 3.22 | 3.20, 3.21, 3.22 |
| armhf | None | None | None |
| s390x | None | None | None |
| ppc64le | None | None | None |
| riscv64 | None | None | None |

## Install preview versions

Expand All @@ -69,15 +74,16 @@ 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+
### 3.20+

- ca-certificates-bundle
- ca-certificates
- libgcc
- libssl3
- libstdc++
- zlib
- icu-libs and icu-data-full (unless the .NET app is running in [globalization-invariant mode](../runtime-config/globalization.md#invariant-mode)
- libgdiplus (if the .NET app requires the *System.Drawing.Common* assembly)
- zlib (.NET 8 only)
- icu-libs and icu-data-full (unless the .NET app is running in [globalization-invariant mode](../runtime-config/globalization.md#invariant-mode))
- tzdata
- krb5

Use the `apk add` command to install the dependencies.

Expand Down
Loading