You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* Cleanup wording
* Update wording
* Provide a better explanation on portable builds
* Update linux-support.md
Co-authored-by: Maira Wenzel <[email protected]>
* Merge all content into a single document
* Add additional container registries
* Update support.md
Co-authored-by: Jan Kotas <[email protected]>
---------
Co-authored-by: Maira Wenzel <[email protected]>
Co-authored-by: Jan Kotas <[email protected]>
Portable builds supports both [glibc](https://www.gnu.org/software/libc/)-based and [musl libc](https://musl.libc.org/)-based Linux distributions, per the following minimum version information.
You can use the following pattern to determine the libc version provided for your distribution.
29
-
30
-
On Alpine:
31
-
32
-
```bash
33
-
# ldd --version
34
-
musl libc (aarch64)
35
-
Version 1.2.3
36
-
```
37
-
38
-
On Ubuntu:
39
-
40
-
```bash
41
-
# ldd --version
42
-
ldd (Ubuntu GLIBC 2.35-0ubuntu3.1) 2.35
43
-
```
44
-
45
-
## OpenSSL compatibility
46
-
47
-
Portable builds support both OpenSSL 1.x and 3.x and can be run on distributions with either version of OpenSSL. For example, Ubuntu 22.04 only includes OpenSSL 3 in its official package archive.
48
-
49
-
The highest OpenSSL version is loaded by default, but it can be [configured to use a specific version](https://github.com/dotnet/runtime/issues/79153#issuecomment-1335476471).
50
-
51
-
## Red Hat Enterprise Linux support
52
-
53
-
New .NET versions will typically only be supported on Red Hat Enterprise Linux (RHEL) versions in active support.
54
-
55
-
- RHEL 7 is considered in maintenance.
56
-
- RHEL 8 is considered in active support.
57
-
- RHEL 9 is considered in active support.
58
-
59
-
RHEL compatible distributions are supported, including: AlmaLinux, CentOS, Oracle Linux, and Rocky Linux.
3
+
This content has been moved to [linux.md](linux.md).
Copy file name to clipboardExpand all lines: linux.md
+61-10Lines changed: 61 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,10 +1,22 @@
1
-
# .NET for Linux Distributions
1
+
# .NET Support and Compatibility for Linux Distributions
2
2
3
-
.NET can be installed on Linux in multiple ways, via [packages](https://learn.microsoft.com/dotnet/core/install/linux), [scripts](https://github.com/dotnet/install-scripts), or [tarballs](https://dotnet.microsoft.com/download/dotnet). It can be installed globally, locally/privately, or with an app.
3
+
.NET can be [installed](https://learn.microsoft.com/dotnet/core/install/linux) and run on almost any Linux distribution. Packages that are available in a given distribution are compatible with that distribution. Packages and binaries from Microsoft are compatible with a broad set of distributions.
4
4
5
-
.NET is supported on Linux per [.NET Support and Compatibility for Linux Distributions](linux-support.md).
5
+
The community provides best effort support for .NET across all Linux distributions. [Commercial support](support.md) is provided for some popular distributions.
6
6
7
-
## Package archives
7
+
## Containers
8
+
9
+
.NET containers are published to multiple registries.
Note: Microsoft publishes container images per [.NET container publishing policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md). Other distributions may have different policies.
18
+
19
+
## Packages
8
20
9
21
.NET is included in the package archives of the following distributions:
10
22
@@ -28,15 +40,54 @@ Microsoft offers alternate package feeds at [packages.microsoft.com](http://pack
28
40
29
41
Microsoft is [no longer publishing packages for Ubuntu starting with Ubuntu 24.04](https://github.com/dotnet/core/discussions/9258).
30
42
31
-
## Containers
43
+
[SDK feature bands](https://learn.microsoft.com/en-us/dotnet/core/releases-and-support#feature-bands-sdk-only) are the only significant difference between Microsoft and distro-provided builds. Distro-provided SDK builds are always within the `.1xx` feature band, while Microsoft SDK builds are always for the latest feature band, for example `.2xx`.
32
44
33
-
.NET containers are published to multiple registries.
Portable builds are compiled to provide [broad compatibility](https://github.com/dotnet/runtime/issues/83428). The minimum supported libc version is documented in [.NET Supported OS Policy](./os-lifecycle-policy.md).
56
+
57
+
Microsoft provides [portable builds](https://dotnet.microsoft.com/download/dotnet) that support both [glibc](https://www.gnu.org/software/libc/)-based and [musl libc](https://musl.libc.org/)-based Linux distributions.
58
+
59
+
The following examples demonstrate how to find the libc version provided for your distribution.
60
+
61
+
On Alpine 3.13:
62
+
63
+
```bash
64
+
# ldd --version
65
+
musl libc (aarch64)
66
+
Version 1.2.2
67
+
```
68
+
69
+
On Ubuntu 16.04:
70
+
71
+
```bash
72
+
# ldd --version
73
+
ldd (Ubuntu GLIBC 2.23-0ubuntu11.3) 2.23
74
+
```
75
+
76
+
## OpenSSL compatibility
77
+
78
+
Portable builds support both OpenSSL 1.x and 3.x and can be run on distributions with either version of OpenSSL. For example, Ubuntu 22.04 only includes OpenSSL 3 in its official package archive.
79
+
80
+
The highest OpenSSL version is loaded by default, but it can be [configured to use a specific version](https://github.com/dotnet/runtime/issues/79153#issuecomment-1335476471).
81
+
82
+
## Red Hat Enterprise Linux support
83
+
84
+
RHEL-compatible distributions are supported, including: AlmaLinux, CentOS Stream, Oracle Linux, and Rocky Linux.
85
+
86
+
New .NET versions will typically only be supported on Red Hat Enterprise Linux (RHEL) versions in active support.
38
87
39
-
Microsoft publishes container images per [.NET container publishing policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md). Other distributions may have different policies.
.NET is available (as a binary distribution) in many package managers and official download sites. These builds of .NET are provided and supported by organizations that participate in the .NET community, [build .NET from source](https://github.com/dotnet/dotnet), and offer stable binaries to their users. These organizations work together to enable developers to be productive and safe on Linux, macOS, and Windows.
3
+
.NET binaries, packages, and container images are provided and supported by organizations that participate in the .NET community, [build .NET from source](https://github.com/dotnet/dotnet), and offer regularly updated assets to their users. These organizations work together to enable developers to be productive and safe on Linux, macOS, and Windows.
4
4
5
-
Patches are provided for functional or security issues, typically monthly on [Patch Tuesday](https://en.wikipedia.org/wiki/Patch_Tuesday).
5
+
## Policies
6
6
7
7
.NET is supported per the following policies:
8
8
9
9
*[.NET releases](releases.md)
10
10
*[.NET release policies](release-policies.md)
11
-
*[.NET supported operating system lifecycle](os-lifecycle-policy.md).
11
+
*[.NET supported operating system lifecycle](os-lifecycle-policy.md)
12
+
13
+
## Community support
12
14
13
15
Community support is available on GitHub, such as at [dotnet/core](https://github.com/dotnet/core).
14
16
15
-
Community builds are available for [Linux](linux.md) and [macOS](https://formulae.brew.sh/cask/dotnet-sdk).
17
+
Community builds are available for [FreeBSD](https://wiki.freebsd.org/.NET), [Linux](linux.md), and [macOS](https://formulae.brew.sh/cask/dotnet-sdk)
18
+
19
+
## Commercial support
16
20
17
-
Official builds and commercial support is available from the following companies:
21
+
Commercial support is provided by the following companies.
18
22
19
-
## Canonical
23
+
###Canonical
20
24
21
25
Canonical supports .NET on Ubuntu, per the following.
22
26
23
-
- .NET 6 is supported in Ubuntu 22.04.
24
-
- .NET 7 is supported in Ubuntu 22.04.
25
-
- .NET 8 is supported in Ubuntu 23.10+.
27
+
* .NET 6 is supported in Ubuntu 22.04+
28
+
* .NET 8 is supported in Ubuntu 22.04+.
26
29
27
-
## Microsoft
30
+
###Microsoft
28
31
29
-
Microsoft provides [stable builds](https://dotnet.microsoft.com/download) and [commercial support](https://support.serviceshub.microsoft.com/supportforbusiness/onboarding) for .NET on Linux, macOS, and Windows, per [.NET support policy](https://dotnet.microsoft.com/platform/support/policy).
32
+
Microsoft provides [stable builds](https://dotnet.microsoft.com/download) and [commercial support](https://support.serviceshub.microsoft.com/supportforbusiness/onboarding) for .NET on [multiple operating systems](os-lifecycle-policy.md), per [.NET support policy](https://dotnet.microsoft.com/platform/support/policy).
30
33
31
-
A more restrictive policy is used for [.NET container images](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md).
34
+
.NET container images are provided for a more limited set of [operating system versions](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md).
32
35
33
-
## Red Hat
36
+
###Red Hat
34
37
35
38
Red Hat supports .NET on Red Hat Enterprise Linux, per [.NET life cycle policy](https://access.redhat.com/support/policy/updates/net-core).
0 commit comments