Document macOS is not supported for production server workloads - #37418
Document macOS is not supported for production server workloads#37418wadepickett with Copilot wants to merge 10 commits into
Conversation
Co-authored-by: wadepickett <10985336+wadepickett@users.noreply.github.com>
There was a problem hiding this comment.
Pull request overview
This PR updates the Web server implementations in ASP.NET Core article to clarify that macOS is suitable for development/test/CI scenarios but isn’t intended for production server workloads, helping readers choose Windows or Linux for production hosting.
Changes:
- Added a
[!NOTE]in the macOS tab warning against using macOS for production server workloads (in both moniker sections). - Updated article metadata (
ai-usage) and refreshedms.date.
Suppressed comments (1)
aspnetcore/fundamentals/servers/index.md:138
- The note says "There are no server editions of macOS". Since the intent is that macOS doesn’t have a server edition/SKU, the singular form reads more clearly.
> macOS is supported for ASP.NET Core development, testing, and continuous integration (CI), but not for production server workloads. There are no server editions of macOS, and [Apple discontinued macOS Server](https://support.apple.com/101601). For production hosting, use Windows or Linux.
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.
Suppressed comments (2)
aspnetcore/fundamentals/servers/index.md:8
ms.dateshould reflect the actual current date (MM/DD/YYYY). The PR metadata timestamp is 2026-08-05, but this file is set to 08/04/2026.
ms.date: 08/04/2026
aspnetcore/fundamentals/servers/index.md:77
- Make the macOS note text consistent between moniker sections and use the grammatically correct/plural form (matches the second note block).
> macOS is supported for ASP.NET Core development, testing, and continuous integration (CI), but not for production server workloads. There is no server edition of macOS, and [Apple discontinued macOS Server](https://support.apple.com/101601). For production hosting, use Windows or Linux.
|
@BrennanConroy, this new note statement would only show on the macOS tab of this article Web server implementations in ASP.NET Core Does the new Note sound good to you? |
BrennanConroy
left a comment
BrennanConroy
left a comment
There was a problem hiding this comment.
Are there more places we mention mac that might need a small wording adjustment? e.g. https://review.learn.microsoft.com/aspnet/core/fundamentals/servers/kestrel
Co-authored-by: Brennan <brecon@microsoft.com>
Thanks @BrennanConroy, you are right, that article is a good one to add the note to. I will add that one here in this PR, plus there are these other two candidates: aspnetcore/fundamentals/servers/yarp/getting-started.md: Optional / borderline aspnetcore/grpc/supported-platforms.md |
|
@copilot, add the same note as it would best fit for the following two articles: aspnetcore/grpc/supported-platforms.md |
Co-authored-by: wadepickett <10985336+wadepickett@users.noreply.github.com>
Added the note to both articles, using the updated wording from this PR. Also aligned the second moniker note in |
Clarified macOS support for ASP.NET Core regarding HTTPS hosting.
Co-authored-by: Wade Pickett <wpickett@microsoft.com>
|
@copilot, add the same note as it would best fit for the following article. Adjust the the context around it if needed to be accurate. |
|
@BrennanConroy, sorry, I accidently asked fora new review/approval but had not finished. I will send out a new request when it is. |
Co-authored-by: wadepickett <10985336+wadepickett@users.noreply.github.com>
Added in f54ba5e. The note is in |
|
@BrennanConroy, ready for review. Added macOS note to three more files:
|
Co-authored-by: Brennan <brecon@microsoft.com> Co-authored-by: Wade Pickett <wpickett@microsoft.com>
macOS has no server SKU (Apple discontinued macOS Server in 2022) and its SLA permits cloud hosting only for developer services like CI. The web server implementations article listed macOS alongside Windows/Linux without this distinction.
Changes
aspnetcore/fundamentals/servers/index.md[!NOTE]to the macOS tab clarifying macOS is supported for development, testing, and CI—but not production—directing readers to Windows or Linux for production hosting.>= aspnetcore-2.2and< aspnetcore-2.2).ms.date; addedai-usage: ai-assistedmetadata.Note text:
Internal previews