.NET Framework Runtime

April 14, 2026 ยท View on GitHub

  • 4.8.1
    • docker pull mcr.microsoft.com/dotnet/framework/runtime:4.8.1
  • 4.8
    • docker pull mcr.microsoft.com/dotnet/framework/runtime:4.8

About

This image contains the .NET Framework runtimes and libraries and is optimized for running .NET Framework apps in production.

Watch discussions for Docker-related .NET announcements.

Usage

The .NET Framework Docker samples show various ways to use .NET Framework and Docker together.

Container sample: Run a simple application

You can quickly run a container with a pre-built .NET Framework Docker image, based on the .NET Framework console sample.

Type the following command to run a sample console application:

docker run --rm mcr.microsoft.com/dotnet/framework/samples:dotnetapp

Version Compatibility

If you created your app using an earlier version of .NET Framework, you can generally upgrade it to .NET Framework 4.8+ easily. Additionally, .NET Framework 4.8 and 4.8.1 can run apps that were built targeting any version of .NET Framework 4.

.NET Framework:

.NET:

Full Tag Listing

Windows amd64 Tags

TagsDockerfileOS Version
4.8.1-20260414-windowsservercore-ltsc2025, 4.8.1-windowsservercore-ltsc2025, 4.8.1DockerfileWindows Server Core 2025
4.8.1-20260414-windowsservercore-ltsc2022, 4.8.1-windowsservercore-ltsc2022, 4.8.1DockerfileWindows Server Core 2022
4.8-20260414-windowsservercore-ltsc2019, 4.8-windowsservercore-ltsc2019, 4.8, latestDockerfileWindows Server Core 2019
4.8-20260414-windowsservercore-ltsc2016, 4.8-windowsservercore-ltsc2016, 4.8, latestDockerfileWindows Server Core 2016

Tags not listed in the table above are not supported. See the Supported Tags Policy. See the full list of tags for all supported and unsupported tags.

Support

Lifecycle

Image Update Policy

  • We update the supported .NET Framework images within 12 hours of any updates to their base images (e.g. windows/servercore:ltsc2019, windows/servercore:ltsc2022, etc.).
  • We publish .NET Framework images as part of releasing new versions of .NET Framework including major/minor and servicing.

Feedback

License