Skip to content

Clarify that Debian images will not be shipped for .NET 10 #49953

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
merged 3 commits into from
Nov 19, 2025
Merged

Clarify that Debian images will not be shipped for .NET 10 #49953

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
bc7395d
Initial plan
Copilot Nov 18, 2025
f779120
Clarify that Debian images will not be shipped for .NET 10
Copilot Nov 18, 2025
63a8f62
Apply suggestions from code review
lbussell Nov 18, 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
8 changes: 5 additions & 3 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 @@ -12,7 +12,7 @@ The default Linux distro for .NET tags has been changed from Debian to Ubuntu. T
- `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"

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).
Debian container images will not be shipped for .NET 10. 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 @@ -24,7 +24,7 @@ In .NET 9 and earlier versions, default tags referenced images based on Debian.

## New behavior

Starting in .NET 10, default tags reference images based on Ubuntu.
Starting in .NET 10, the default container image tags reference Ubuntu images. Additionally, Debian-based images are no longer provided.

## Type of breaking change

Expand All @@ -36,7 +36,9 @@ Debian and .NET release cycles (for mainline support) are the same length, while

## Recommended action

Test your application. This change is unlikely to affect users.
Test your application with Ubuntu-based images. This change is unlikely to affect most users.

If you specifically require Debian-based images for .NET 10, you may need to create and maintain custom container images. Please see [installing .NET in a Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/documentation/scenarios/installing-dotnet.md) for details on how to create your own .NET container images.

## Affected APIs

Expand Down
Loading