Sunday, January 4, 2026

.NET 10: Default Container Images Changed from Debian to Ubuntu

When you are upgrading your .NET application to .NET 10 and using Docker, you might run into build errors where certain apt-get packages are no longer available.

Starting with .NET 10, the default Linux distribution for .NET container images has been changed from Debian to Ubuntu 24.04 "Noble Numbat". This was based on a poor match between Debian and .NET lifecycles.

This means if your Dockerfile installs any Debian-specific packages using apt-get, those packages might not be available or might have different names in Ubuntu.

FROM mcr.microsoft.com/dotnet/aspnet:10.0 AS base
RUN apt-get update -y \
    && apt-get install -y some-debian-package  # This might fail!

The fix is to find the equivalent Ubuntu package name and update your Dockerfile accordingly. You can search for Ubuntu packages at https://packages.ubuntu.com/.

Note that Debian container images will NOT be shipped for .NET 10. If you specifically need Debian-based images, you will need to create custom container images.

So this is something to look out for when upgrading.

More information:
   .NET 10: Default .NET images use Ubuntu

Hope this helps.

Happy Coding.

Regards,
Jaliya

No comments:

Post a Comment