Skip to content

Update supported OS matrix #10313

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.

Sign up for GitHub

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
richlander merged 5 commits into from
Mar 17, 2026
+330 −321
Merged

Update supported OS matrix #10313

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
1d794fe
Update supported OS matrix
richlander Mar 12, 2026
500122b
Regenerate supported-os.md with improved table formatting
richlander Mar 13, 2026
846aac5
Regenerate supported-os.md with overflow padding fix
richlander Mar 13, 2026
ed22aff
Regenerate supported-os.md with multi-modal table widths
richlander Mar 13, 2026
9e5f9ff
Regenerate supported-os.md with trailing pipe clustering
richlander Mar 13, 2026
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
28 changes: 16 additions & 12 deletions release-notes/10.0/supported-os.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"channel-version": "10.0",
"last-updated": "2025-12-07",
"last-updated": "2026-03-12",
"families": [
{
"name": "Android",
Expand All @@ -11,7 +11,8 @@
"link": "https://www.android.com/",
"lifecycle": "https://support.google.com/android",
"architectures": ["Arm32", "Arm64", "x64"],
"supported-versions": ["16", "15", "14", "13"],
"supported-versions": ["16", "15", "14"],
"unsupported-versions": ["13"],
"notes": ["API 21 is used as the minimum SDK target."]
}
]
Expand All @@ -32,7 +33,7 @@
"name": "iPadOS",
"link": "https://developer.apple.com/ipados/",
"architectures": ["Arm64"],
"supported-versions": ["26", "18"]
"supported-versions": ["26", "18", "17"]
},
{
"id": "macos",
Expand Down Expand Up @@ -64,7 +65,7 @@
"link": "https://alpinelinux.org/",
"lifecycle": "https://alpinelinux.org/releases/",
"architectures": ["Arm32", "Arm64", "x64"],
"supported-versions": ["3.22"]
"supported-versions": ["3.23", "3.22", "3.21", "3.20"]
},
{
"id": "azure-linux",
Expand Down Expand Up @@ -122,7 +123,8 @@
"link": "https://www.suse.com/",
"lifecycle": "https://www.suse.com/lifecycle/",
"architectures": ["Arm64", "x64"],
"supported-versions": ["16.0", "15.7", "15.6"]
"supported-versions": ["16.0", "15.7"],
"unsupported-versions": ["15.6"]
},
{
"id": "ubuntu",
Expand Down Expand Up @@ -152,19 +154,21 @@
"lifecycle": "https://support.microsoft.com/help/13853/windows-lifecycle-fact-sheet",
"architectures": ["Arm64", "x64"],
"supported-versions": [
"11-26h1-e",
"11-26h1-w",
"11-25h2-e",
"11-25h2-w",
"11-24h2-iot-lts",
"11-24h2-e-lts",
"11-24h2-e",
"11-24h2-w",
"11-23h2-e",
"11-23h2-w",
"10-21h2-e-lts",
"10-21h2-iot-lts",
"10-1809-e-lts",
"10-1607-e-lts"
],
"unsupported-versions": ["11-23h2-w"],
"notes": [
"The x64 and x86 emulators are supported on Windows 11 Arm64.",
"The x86 emulator is supported on x64."
Expand All @@ -182,11 +186,11 @@
"2022",
"2019",
"2016",
"2012-R2",
"2012"
"2012-R2"
],
"unsupported-versions": ["2012"],
"notes": [
"Windows Server 2012 and 2012 R2 are supported with [Extended Security Updates](https://learn.microsoft.com/windows-server/get-started/extended-security-updates-overview)."
"Windows Server 2012 R2 is supported with [Extended Security Updates](https://learn.microsoft.com/windows-server/get-started/extended-security-updates-overview)."
]
},
{
Expand All @@ -200,11 +204,11 @@
"2022",
"2019",
"2016",
"2012-R2",
"2012"
"2012-R2"
],
"unsupported-versions": ["2012"],
"notes": [
"Windows Server 2012 and 2012 R2 are supported with [Extended Security Updates](https://learn.microsoft.com/windows-server/get-started/extended-security-updates-overview)."
"Windows Server 2012 R2 is supported with [Extended Security Updates](https://learn.microsoft.com/windows-server/get-started/extended-security-updates-overview)."
]
}
]
Expand Down
140 changes: 70 additions & 70 deletions release-notes/10.0/supported-os.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,61 +1,75 @@
# .NET 10.0 - Supported OS versions

Last Updated: 2025/12/07; Support phase: Active
Last Updated: 2026/03/12; Support phase: Unknown

[.NET 10.0](README.md) is an [LTS](../../release-policies.md) release and [is supported](../../support.md) on multiple operating systems per their lifecycle policy.
[.NET 10.0](README.md) is an [Unknown](../../release-policies.md) release and [is supported](../../support.md) on multiple operating systems per their lifecycle policy.

## Android

| OS | Versions | Architectures | Lifecycle |
| ------------ | -------------- | ----------------- | -------------- |
| [Android][0] | 16, 15, 14, 13 | Arm32, Arm64, x64 | [Lifecycle][1] |
| OS | Versions | Architectures | Lifecycle |
| ------------ | ---------- | ----------------- | -------------- |
| [Android][0] | 16, 15, 14 | Arm32, Arm64, x64 | [Lifecycle][1] |

Notes:

* Android: API 21 is used as the minimum SDK target.

[0]: https://www.android.com/
[1]: https://support.google.com/android
- Android: API 21 is used as the minimum SDK target.

## Apple

| OS | Versions | Architectures | Lifecycle |
| ---------- | -------- | ------------- | --------- |
| [iOS][2] | 26, 18 | Arm64 | None |
| [iPadOS][3] | 26, 18 | Arm64 | None |
| [macOS][4] | 26, 15, 14 | Arm64, x64 | None |
| [tvOS][5] | 26 | Arm64 | None |
| OS | Versions | Architectures | Lifecycle |
| ----------- | ---------- | ------------- | --------- |
| [iOS][2] | 26, 18 | Arm64 | None |
| [iPadOS][3] | 26, 18, 17 | Arm64 | None |
| [macOS][4] | 26, 15, 14 | Arm64, x64 | None |
| [tvOS][5] | 26 | Arm64 | None |

Notes:

* iOS: iOS 12.2 is used as the minimum SDK target.
* macOS: The iOS and tvOS simulators are supported on macOS Arm64 and x64.
* macOS: The x64 emulator (Rosetta 2) is supported on macOS Arm64.
* macOS: Mac Catalyst apps are supported on macOS Arm64 and x64.

[2]: https://developer.apple.com/ios/
[3]: https://developer.apple.com/ipados/
[4]: https://developer.apple.com/macos/
[5]: https://developer.apple.com/tvos/
- iOS: iOS 12.2 is used as the minimum SDK target.
- macOS: The iOS and tvOS simulators are supported on macOS Arm64 and x64.
- macOS: The x64 emulator (Rosetta 2) is supported on macOS Arm64.
- macOS: Mac Catalyst apps are supported on macOS Arm64 and x64.

## Linux

| OS | Versions | Architectures | Lifecycle |
| ------------------- | -------- | ----------------- | --------------- |
| [Alpine][6] | 3.22 | Arm32, Arm64, x64 | [Lifecycle][7] |
| [Azure Linux][8] | 3.0 | Arm64, x64 | None |
| [CentOS Stream][9] | 10, 9 | Arm64, ppc64le, s390x, x64 | [Lifecycle][10] |
| [Debian][11] | 13, 12 | Arm32, Arm64, x64 | [Lifecycle][12] |
| [Fedora][13] | 43, 42 | Arm32, Arm64, x64 | [Lifecycle][14] |
| [openSUSE Leap][15] | 16.0, 15.6 | Arm64, x64 | [Lifecycle][16] |
| [Red Hat Enterprise Linux][17] | 10, 9, 8 | Arm64, ppc64le, s390x, x64 | [Lifecycle][18] |
| [SUSE Linux Enterprise][19] | 16.0, 15.7, 15.6 | Arm64, x64 | [Lifecycle][20] |
| [Ubuntu][21] | 25.10, 24.04, 22.04 | Arm32, Arm64, x64 | [Lifecycle][22] |
| OS | Versions | Architectures | Lifecycle |
| ------------------------------ | ---------------------- | -------------------------- | --------------- |
| [Alpine][6] | 3.23, 3.22, 3.21, 3.20 | Arm32, Arm64, x64 | [Lifecycle][7] |
| [Azure Linux][8] | 3.0 | Arm64, x64 | None |
| [CentOS Stream][9] | 10, 9 | Arm64, ppc64le, s390x, x64 | [Lifecycle][10] |
| [Debian][11] | 13, 12 | Arm32, Arm64, x64 | [Lifecycle][12] |
| [Fedora][13] | 43, 42 | Arm32, Arm64, x64 | [Lifecycle][14] |
| [openSUSE Leap][15] | 16.0, 15.6 | Arm64, x64 | [Lifecycle][16] |
| [Red Hat Enterprise Linux][17] | 10, 9, 8 | Arm64, ppc64le, s390x, x64 | [Lifecycle][18] |
| [SUSE Linux Enterprise][19] | 16.0, 15.7 | Arm64, x64 | [Lifecycle][20] |
| [Ubuntu][21] | 25.10, 24.04, 22.04 | Arm32, Arm64, x64 | [Lifecycle][22] |

Notes:

* Red Hat Enterprise Linux: RHEL-compatible derivatives are supported per [.NET Support](../../support.md).
- Red Hat Enterprise Linux: RHEL-compatible derivatives are supported per [.NET Support](../../support.md).

## Windows

| OS | Versions | Architectures | Lifecycle |
| ------------------------- | ------------------------------------- | ------------- | --------------- |
| [Nano Server][23] | 2025, 2022, 2019 | x64 | [Lifecycle][24] |
| [Windows][25] | 11 26H1, 11 25H2, 11 24H2 (IoT), 11 24H2 (E), 11 24H2, 11 23H2 (E), 10 21H2 (E), 10 21H2 (IoT), 10 1809 (E), 10 1607 (E) | Arm64, x64 | [Lifecycle][26] |
| [Windows Server][27] | 2025, 23H2, 2022, 2019, 2016, 2012-R2 | x64 | [Lifecycle][28] |
| [Windows Server Core][29] | 2025, 2022, 2019, 2016, 2012-R2 | x64 | [Lifecycle][30] |

Notes:

- Windows: The x64 and x86 emulators are supported on Windows 11 Arm64.
- Windows: The x86 emulator is supported on x64.
- Windows Server: Windows Server 2012 R2 is supported with [Extended Security Updates](https://learn.microsoft.com/windows-server/get-started/extended-security-updates-overview).
- Windows Server Core: Windows Server 2012 R2 is supported with [Extended Security Updates](https://learn.microsoft.com/windows-server/get-started/extended-security-updates-overview).

[0]: https://www.android.com/
[1]: https://support.google.com/android
[2]: https://developer.apple.com/ios/
[3]: https://developer.apple.com/ipados/
[4]: https://developer.apple.com/macos/
[5]: https://developer.apple.com/tvos/
[6]: https://alpinelinux.org/
[7]: https://alpinelinux.org/releases/
[8]: https://github.com/microsoft/azurelinux
Expand All @@ -73,50 +87,36 @@ Notes:
[20]: https://www.suse.com/lifecycle/
[21]: https://ubuntu.com/
[22]: https://wiki.ubuntu.com/Releases

## Windows

| OS | Versions | Architectures | Lifecycle |
| -------------------- | ------------------------------------------- | ------------- | --------------- |
| [Nano Server][23] | 2025, 2022, 2019 | x64 | [Lifecycle][24] |
| [Windows][25] | 11 25H2, 11 24H2 (IoT), 11 24H2 (E), 11 24H2, 11 23H2, 10 21H2 (E), 10 21H2 (IoT), 10 1809 (E), 10 1607 (E) | Arm64, x64 | [Lifecycle][26] |
| [Windows Server][27] | 2025, 23H2, 2022, 2019, 2016, 2012-R2, 2012 | x64 | [Lifecycle][24] |
| [Windows Server Core][23] | 2025, 2022, 2019, 2016, 2012-R2, 2012 | x64 | [Lifecycle][24] |

Notes:

* Windows: The x64 and x86 emulators are supported on Windows 11 Arm64.
* Windows: The x86 emulator is supported on x64.
* Windows Server: Windows Server 2012 and 2012 R2 are supported with [Extended Security Updates](https://learn.microsoft.com/windows-server/get-started/extended-security-updates-overview).
* Windows Server Core: Windows Server 2012 and 2012 R2 are supported with [Extended Security Updates](https://learn.microsoft.com/windows-server/get-started/extended-security-updates-overview).

[23]: https://learn.microsoft.com/virtualization/windowscontainers/manage-containers/container-base-images
[24]: https://learn.microsoft.com/windows-server/get-started/windows-server-release-info
[25]: https://www.microsoft.com/windows/
[26]: https://support.microsoft.com/help/13853/windows-lifecycle-fact-sheet
[27]: https://www.microsoft.com/windows-server
[28]: https://learn.microsoft.com/windows-server/get-started/windows-server-release-info
[29]: https://learn.microsoft.com/virtualization/windowscontainers/manage-containers/container-base-images
[30]: https://learn.microsoft.com/windows-server/get-started/windows-server-release-info

## Linux compatibility
## Libc

Microsoft-provided [portable Linux builds](../../linux.md) define minimum compatibility primarily via libc version.

| Libc | Version | Architectures | Source |
| ----- | ------- | ------------- | ------------ |
| glibc | 2.27 | Arm64, x64 | Ubuntu 18.04 |
| glibc | 2.35 | Arm32 | Ubuntu 22.04 |
| musl | 1.2.3 | Arm32, Arm64, x64 | Alpine 3.17 |
| Libc | Version | Architectures | Source |
| ----- | ------- | ----------------- | ------------ |
| glibc | 2.27 | Arm64, x64 | Ubuntu 18.04 |
| glibc | 2.35 | Arm32 | Ubuntu 22.04 |
| musl | 1.2.3 | Arm32, Arm64, x64 | Alpine 3.17 |

## Notes

* The [QEMU](https://www.qemu.org/) emulator is not supported to run .NET apps. QEMU is used, for example, to emulate Arm64 containers on x64, and vice versa.
* Microsoft-provided portable Arm32 glibc builds are supported on distro versions with a [Y2038 compatible glibc](https://github.com/dotnet/core/discussions/9285), for example Debian 12, Ubuntu 22.04, and higher versions.

## Out of support

The following operating system versions are no longer supported.
- The [QEMU](https://www.qemu.org/) emulator is not supported to run .NET apps. QEMU is used, for example, to emulate Arm64 containers on x64, and vice versa.
- Microsoft-provided portable Arm32 glibc builds are supported on distro versions with a [Y2038 compatible glibc](https://github.com/dotnet/core/discussions/9285), for example Debian 12, Ubuntu 22.04, and higher versions.

None currently.
## Out of support OS versions

## About
OS versions that are out of support by the OS publisher are not tested or supported by .NET.

This file is generated from [supported-os.json](supported-os.json) and is based (with thanks) on support information from [endoflife.date](https://endoflife.date/).
| OS | Version | End of Life |
| --------------------- | ----------- | ---------------------------------------------------------------------------------------------- |
| Android | 13 | 2026-03-02 |
| SUSE Linux Enterprise | 15.6 | 2025-12-31 |
| Windows | 11 23H2 (W) | [2025-11-11](https://learn.microsoft.com/windows/release-health/windows11-release-information) |
| Windows Server | 2012 | [2023-10-10](https://learn.microsoft.com/lifecycle/products/windows-server-2012) |
| Windows Server Core | 2012 | [2023-10-10](https://learn.microsoft.com/lifecycle/products/windows-server-2012) |
36 changes: 19 additions & 17 deletions release-notes/8.0/supported-os.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"channel-version": "8.0",
"last-updated": "2025-10-28",
"last-updated": "2026-03-12",
"families": [
{
"name": "Android",
Expand All @@ -11,8 +11,8 @@
"link": "https://www.android.com/",
"lifecycle": "https://support.google.com/android",
"architectures": ["Arm32", "Arm64", "x64"],
"supported-versions": ["16", "15", "14", "13"],
"unsupported-versions": ["12.1", "12", "11"],
"supported-versions": ["16", "15", "14"],
"unsupported-versions": ["13", "12.1", "12", "11"],
"notes": ["API 21 is used as the minimum SDK target."]
}
]
Expand Down Expand Up @@ -55,8 +55,8 @@
"name": "tvOS",
"link": "https://developer.apple.com/tvos/",
"architectures": ["Arm64"],
"supported-versions": ["26", "18"],
"unsupported-versions": ["17", "16", "15", "14", "13", "12.2"]
"supported-versions": ["26"],
"unsupported-versions": ["18", "17", "16", "15", "14", "13", "12.2"]
}
]
},
Expand All @@ -69,7 +69,7 @@
"link": "https://alpinelinux.org/",
"lifecycle": "https://alpinelinux.org/releases/",
"architectures": ["Arm32", "Arm64", "x64"],
"supported-versions": ["3.22", "3.21", "3.20"],
"supported-versions": ["3.23", "3.22", "3.21", "3.20"],
"unsupported-versions": ["3.19", "3.18", "3.17", "3.16"]
},
{
Expand Down Expand Up @@ -102,8 +102,8 @@
"link": "https://fedoraproject.org/",
"lifecycle": "https://fedoraproject.org/wiki/End_of_life",
"architectures": ["Arm32", "Arm64", "x64"],
"supported-versions": ["43", "42", "41"],
"unsupported-versions": ["40", "39", "38", "37"]
"supported-versions": ["43", "42"],
"unsupported-versions": ["41", "40", "39", "38", "37"]
},
{
"id": "opensuse",
Expand Down Expand Up @@ -131,8 +131,8 @@
"link": "https://www.suse.com/",
"lifecycle": "https://www.suse.com/lifecycle/",
"architectures": ["Arm64", "x64"],
"supported-versions": ["16.0", "15.7", "15.6"],
"unsupported-versions": ["15.5", "15.4", "12.5"]
"supported-versions": ["16.0", "15.7"],
"unsupported-versions": ["15.6", "15.5", "15.4", "12.5"]
},
{
"id": "ubuntu",
Expand Down Expand Up @@ -163,20 +163,22 @@
"lifecycle": "https://support.microsoft.com/help/13853/windows-lifecycle-fact-sheet",
"architectures": ["Arm64", "x64"],
"supported-versions": [
"11-26h1-e",
"11-26h1-w",
"11-25h2-e",
"11-25h2-w",
"11-24h2-iot-lts",
"11-24h2-e-lts",
"11-24h2-e",
"11-24h2-w",
"11-23h2-e",
"11-23h2-w",
"10-21h2-e-lts",
"10-21h2-iot-lts",
"10-1809-e-lts",
"10-1607-e-lts"
],
"unsupported-versions": [
"11-23h2-w",
"11-22h2-e",
"11-22h2-w",
"11-21h2-e",
Expand All @@ -200,11 +202,11 @@
"2022",
"2019",
"2016",
"2012-R2",
"2012"
"2012-R2"
],
"unsupported-versions": ["2012"],
"notes": [
"Windows Server 2012 and 2012 R2 are supported with [Extended Security Updates](https://learn.microsoft.com/windows-server/get-started/extended-security-updates-overview)."
"Windows Server 2012 R2 is supported with [Extended Security Updates](https://learn.microsoft.com/windows-server/get-started/extended-security-updates-overview)."
]
},
{
Expand All @@ -218,11 +220,11 @@
"2022",
"2019",
"2016",
"2012-R2",
"2012"
"2012-R2"
],
"unsupported-versions": ["2012"],
"notes": [
"Windows Server 2012 and 2012 R2 are supported with [Extended Security Updates](https://learn.microsoft.com/windows-server/get-started/extended-security-updates-overview)."
"Windows Server 2012 R2 is supported with [Extended Security Updates](https://learn.microsoft.com/windows-server/get-started/extended-security-updates-overview)."
]
}
]
Expand Down
Loading
Loading