README.runtime.md

.NET Framework Runtime

Featured tags

• 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
• 3.5
  • docker pull mcr.microsoft.com/dotnet/framework/runtime:3.5

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

Version Tag	OS Version	Supported .NET Versions
4.8.1	windowsservercore-ltsc2022	4.8.1
4.8	windowsservercore-ltsc2022, windowsservercore-ltsc2019, windowsservercore-ltsc2016	4.8
4.7.2	windowsservercore-ltsc2019, windowsservercore-ltsc2016	4.7.2
4.7.1	windowsservercore-ltsc2016	4.7.1
4.7	windowsservercore-ltsc2016	4.7
4.6.2	windowsservercore-ltsc2016	4.6.2
3.5	windowsservercore-ltsc2022	4.7.2, 3.5, 3.0, 2.5
3.5	windowsservercore-ltsc2019	4.7.2, 3.5, 3.0, 2.5
3.5	windowsservercore-ltsc2016	4.6.2, 3.5, 3.0, 2.5

Related repositories

.NET Framework:

• dotnet/framework: .NET Framework
• dotnet/framework/sdk: .NET Framework SDK
• dotnet/framework/aspnet: ASP.NET Web Forms and MVC
• dotnet/framework/wcf: Windows Communication Foundation (WCF)
• dotnet/framework/samples: .NET Framework, ASP.NET and WCF Samples

.NET:

• dotnet: .NET
• dotnet/samples: .NET Samples

Full Tag Listing

Windows Server Core 2022 amd64 Tags

Tag	Dockerfile
4.8.1-20241112-windowsservercore-ltsc2022, 4.8.1-windowsservercore-ltsc2022, 4.8.1	Dockerfile
4.8-20241112-windowsservercore-ltsc2022, 4.8-windowsservercore-ltsc2022, 4.8, latest	Dockerfile
3.5-20241112-windowsservercore-ltsc2022, 3.5-windowsservercore-ltsc2022, 3.5	Dockerfile

Windows Server Core 2019 amd64 Tags

Tag	Dockerfile
4.8-20241112-windowsservercore-ltsc2019, 4.8-windowsservercore-ltsc2019, 4.8, latest	Dockerfile
4.7.2-20241112-windowsservercore-ltsc2019, 4.7.2-windowsservercore-ltsc2019, 4.7.2	Dockerfile
3.5-20241112-windowsservercore-ltsc2019, 3.5-windowsservercore-ltsc2019, 3.5	Dockerfile

Windows Server Core 2016 amd64 Tags

Tag	Dockerfile
4.8-20241112-windowsservercore-ltsc2016, 4.8-windowsservercore-ltsc2016, 4.8, latest	Dockerfile
4.7.2-20241112-windowsservercore-ltsc2016, 4.7.2-windowsservercore-ltsc2016, 4.7.2	Dockerfile
4.7.1-20241112-windowsservercore-ltsc2016, 4.7.1-windowsservercore-ltsc2016, 4.7.1	Dockerfile
4.7-20241112-windowsservercore-ltsc2016, 4.7-windowsservercore-ltsc2016, 4.7	Dockerfile
4.6.2-20241112-windowsservercore-ltsc2016, 4.6.2-windowsservercore-ltsc2016, 4.6.2	Dockerfile
3.5-20241112-windowsservercore-ltsc2016, 3.5-windowsservercore-ltsc2016, 3.5	Dockerfile

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

• .NET Framework Lifecycle FAQ
• Supported Tags Policy

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

• File an issue
• Contact Microsoft Support

License

• Microsoft Container Images Legal Notice: applies to all .NET Framework container images
• Windows Base Image License: applies to all .NET Framework container images
• Visual Studio Tools License: applies to all .NET Framework SDK container images