Skip to content

Commit 0ce7942

Browse files
adegeoCopilot
adegeo
and
Copilot
authored
Installer updates windows/mac/linux (#49686)
* Installer updates windows/mac/linux * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Fix image links --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
1 parent 2dec5a7 commit 0ce7942

25 files changed

+538
-493
lines changed

‎docs/core/install/includes/linux-install-100-apk.md‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
author: adegeo
3+
ms.author: adegeo
4+
ms.date: 11/07/2025
5+
ms.topic: include
6+
ms.custom: linux-related-content
7+
---
8+
9+
### Install the SDK
10+
11+
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:
12+
13+
```bash
14+
sudo apk add dotnet10-sdk
15+
```
16+
17+
To learn how to use the .NET CLI, see [.NET CLI overview](../../tools/index.md).
18+
19+
### Install the runtime
20+
21+
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:
22+
23+
```bash
24+
sudo apk add aspnetcore10-runtime
25+
```
26+
27+
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`:
28+
29+
```bash
30+
sudo apk add dotnet10-runtime
31+
```
32+
33+
To learn how to use the .NET CLI, see [.NET CLI overview](../../tools/index.md).

‎docs/core/install/includes/linux-install-100-apt.md‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
---
2+
author: adegeo
3+
ms.author: adegeo
4+
ms.date: 11/07/2025
5+
ms.topic: include
6+
ms.custom: linux-related-content
7+
---
8+
9+
### Install the SDK
10+
11+
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:
12+
13+
```bash
14+
sudo apt-get update && \
15+
sudo apt-get install -y dotnet-sdk-10.0
16+
```
17+
18+
To learn how to use the .NET CLI, see [.NET CLI overview](../../tools/index.md).
19+
20+
### Install the runtime
21+
22+
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:
23+
24+
```bash
25+
sudo apt-get update && \
26+
sudo apt-get install -y aspnetcore-runtime-10.0
27+
```
28+
29+
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`:
30+
31+
```bash
32+
sudo apt-get install -y dotnet-runtime-10.0
33+
```
34+
35+
To learn how to use the .NET CLI, see [.NET CLI overview](../../tools/index.md).

‎docs/core/install/includes/linux-install-100-dnf.md‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
author: adegeo
3+
ms.author: adegeo
4+
ms.date: 11/07/2025
5+
ms.topic: include
6+
ms.custom: linux-related-content
7+
---
8+
9+
### Install the SDK
10+
11+
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:
12+
13+
```bash
14+
sudo dnf install dotnet-sdk-10.0
15+
```
16+
17+
To learn how to use the .NET CLI, see [.NET CLI overview](../../tools/index.md).
18+
19+
### Install the runtime
20+
21+
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:
22+
23+
```bash
24+
sudo dnf install aspnetcore-runtime-10.0
25+
```
26+
27+
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`:
28+
29+
```bash
30+
sudo dnf install dotnet-runtime-10.0
31+
```
32+
33+
To learn how to use the .NET CLI, see [.NET CLI overview](../../tools/index.md).

‎docs/core/install/includes/linux-install-100-zyp.md‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
author: adegeo
3+
ms.author: adegeo
4+
ms.date: 11/07/2025
5+
ms.topic: include
6+
ms.custom: linux-related-content
7+
---
8+
9+
### Install the SDK
10+
11+
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:
12+
13+
```bash
14+
sudo zypper install dotnet-sdk-10.0
15+
```
16+
17+
To learn how to use the .NET CLI, see [.NET CLI overview](../../tools/index.md).
18+
19+
### Install the runtime
20+
21+
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:
22+
23+
```bash
24+
sudo zypper install aspnetcore-runtime-10.0
25+
```
26+
27+
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`:
28+
29+
```bash
30+
sudo zypper install dotnet-runtime-10.0
31+
```
32+
33+
To learn how to use the .NET CLI, see [.NET CLI overview](../../tools/index.md).

‎docs/core/install/includes/linux-release-wait.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
22
author: adegeo
33
ms.author: adegeo
4-
ms.date: 11/11/2024
4+
ms.date: 11/06/2025
55
ms.topic: include
66
ms.custom: linux-related-content
77
---
88

99
> [!IMPORTANT]
10-
> .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.
10+
> .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.

‎docs/core/install/includes/linux-rpm-install-dependencies.md‎

Lines changed: 0 additions & 24 deletions
This file was deleted.

‎docs/core/install/includes/verify-download-windows.md‎

Lines changed: 0 additions & 58 deletions
This file was deleted.

‎docs/core/install/includes/versions-not-supported.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
author: adegeo
33
ms.author: adegeo
4-
ms.date: 11/11/2024
4+
ms.date: 11/06/2025
55
ms.topic: include
66
---
77

‎docs/core/install/index.yml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ metadata:
77
title: Install .NET on Windows, Linux, and macOS
88
description: Learn where to download and install .NET on Windows, Linux, and macOS. Discover the dependencies required to develop, deploy, and run .NET apps.
99
ms.topic: landing-page
10-
ms.date: 01/26/2023
10+
ms.date: 11/08/2025
1111

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

‎docs/core/install/linux-alpine.md‎

Lines changed: 26 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Install .NET on Alpine
33
description: Learn about which versions of .NET SDK and .NET Runtime are supported, and how to install .NET on Alpine.
44
author: adegeo
55
ms.author: adegeo
6-
ms.date: 12/13/2024
6+
ms.date: 11/07/2025
77
ms.custom: linux-related-content
88
---
99

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

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

16+
[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
17+
1618
[!INCLUDE [linux-intro-sdk-vs-runtime](includes/linux-intro-sdk-vs-runtime.md)]
1719

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

2224
| Alpine | Supported Version | Available in Package Manager |
2325
|--------|-------------------|------------------------------|
26+
| 3.22 | 10.0, 9.0, 8.0 | 9.0, 8.0 |
2427
| 3.21 | 9.0, 8.0 | 9.0, 8.0 |
2528
| 3.20 | 9.0, 8.0 | 8.0, 6.0 |
26-
| 3.19 | 9.0, 8.0 | 7.0, 6.0 |
27-
| 3.18 | 8.0 | 7.0, 6.0 |
2829

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

3132
## Install .NET
3233

33-
# [.NET 9](#tab/dotnet9)
34+
# [.NET 10](#tab/dotnet10)
35+
36+
[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
3437

35-
**Not supported on Alpine 3.18.**
38+
[!INCLUDE [linux-apk-install-100](includes/linux-install-100-apk.md)]
39+
40+
# [.NET 9](#tab/dotnet9)
3641

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

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

4752
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.
4853

49-
| Architecture | .NET 9 | .NET 8 |
50-
|--------------|------------------------|------------------------|
51-
| x86_64 | 3.19, 3.20, 3.21 | 3.18, 3.19, 3.20, 3.21 |
52-
| x86 | None | None |
53-
| aarch64 | 3.19, 3.20, 3.21 | 3.18, 3.19, 3.20, 3.21 |
54-
| armv7 | 3.19, 3.20, 3.21 | 3.18, 3.19, 3.20, 3.21 |
55-
| armhf | None | None |
56-
| s390x | None | None |
57-
| ppc64le | None | None |
58-
| riscv64 | None | None |
54+
| Architecture | .NET 10 | .NET 9 | .NET 8 |
55+
|--------------|----------|-------------------|------------------------|
56+
| x86_64 | 3.22 | 3.20, 3.21, 3.22 | 3.20, 3.21, 3.22 |
57+
| x86 | None | None | None |
58+
| aarch64 | 3.22 | 3.20, 3.21, 3.22 | 3.20, 3.21, 3.22 |
59+
| armv7 | 3.22 | 3.20, 3.21, 3.22 | 3.20, 3.21, 3.22 |
60+
| armhf | None | None | None |
61+
| s390x | None | None | None |
62+
| ppc64le | None | None | None |
63+
| riscv64 | None | None | None |
5964

6065
## Install preview versions
6166

@@ -69,15 +74,16 @@ The following table is a list of currently supported .NET releases and the archi
6974

7075
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:
7176

72-
### 3.18+
77+
### 3.20+
7378

74-
- ca-certificates-bundle
79+
- ca-certificates
7580
- libgcc
7681
- libssl3
7782
- libstdc++
78-
- zlib
79-
- icu-libs and icu-data-full (unless the .NET app is running in [globalization-invariant mode](../runtime-config/globalization.md#invariant-mode)
80-
- libgdiplus (if the .NET app requires the *System.Drawing.Common* assembly)
83+
- zlib (.NET 8 only)
84+
- icu-libs and icu-data-full (unless the .NET app is running in [globalization-invariant mode](../runtime-config/globalization.md#invariant-mode))
85+
- tzdata
86+
- krb5
8187

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

0 commit comments

Comments
 (0)