Skip to content

Update .NET 10 container breaking change doc to reflect final plans #49416

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

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
+4 −8
Open

Update .NET 10 container breaking change doc to reflect final plans #49416

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
7c16cff
Initial plan
Copilot Oct 22, 2025
2d54acd
Update default-images-use-ubuntu.md with latest .NET 10 container ima…
Copilot Oct 22, 2025
73b83be
Add ai-usage frontmatter to indicate AI assistance
Copilot Oct 22, 2025
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
12 changes: 4 additions & 8 deletions docs/core/compatibility/containers/10.0/default-images-use-ubuntu.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,19 +2,17 @@
title: "Default .NET container tags now use Ubuntu"
description: Learn about the breaking change where the default .NET container tags, like `10.0`, use Ubuntu.
ms.date: 2/26/2025
ai-usage: ai-assisted
---

# Default .NET images use Ubuntu

The default Linux distro for .NET tags has been changed from Debian to Ubuntu. This applies to all .NET tags that do not explicitly specify an OS.

Debian images are still produced and supported. They can be referenced using the `-trixie-slim` suffix.
- `docker pull mcr.microsoft.com/dotnet/sdk:10.0` - Refers to Ubuntu 24.04 "Noble Numbat"
- `docker pull mcr.microsoft.com/dotnet/sdk:10.0-noble` - Refers to Ubuntu 24.04 "Noble Numbat"

- `docker pull mcr.microsoft.com/dotnet/sdk:10.0-preview` - Refers to Ubuntu 24.04 "Noble Numbat"
- `docker pull mcr.microsoft.com/dotnet/sdk:10.0-preview-noble` - Refers to Ubuntu 24.04 "Noble Numbat"
- `docker pull mcr.microsoft.com/dotnet/sdk:10.0-preview-trixie-slim` - Refers to Debian 13 "Trixie"

The same change will apply to `10.0` tags once the `-preview` suffix is removed. This change was proposed in [dotnet-docker #5709](https://github.com/dotnet/dotnet-docker/discussions/5709).
For more information about the container image platforms available at .NET 10's launch, see [dotnet-docker #6539](https://github.com/dotnet/dotnet-docker/discussions/6539). This change was proposed in [dotnet-docker #6526](https://github.com/dotnet/dotnet-docker/issues/6526).

## Version introduced

Expand All @@ -40,8 +38,6 @@ Debian and .NET release cycles (for mainline support) are the same length, while

Test your application. This change is unlikely to affect users.

If you prefer Debian or have a dependency on it, use a Debian specific tag, such as `10.0-preview-trixie-slim`.

## Affected APIs

N/A