README.runtime.md

Featured Tags

• 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

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

Watch dotnet/announcements for Docker-related .NET announcements.

How to Use the Image

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

Related Repos

.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-nightly: .NET (Preview)
• dotnet/samples: .NET Samples

Full Tag Listing

Windows Server Core, version 20H2 amd64 Tags

Tag	Dockerfile
4.8-20210112-windowsservercore-20H2, 4.8-windowsservercore-20H2, 4.8, latest	Dockerfile
3.5-20210112-windowsservercore-20H2, 3.5-windowsservercore-20H2, 3.5	Dockerfile

Windows Server Core, version 2004 amd64 Tags

Tag	Dockerfile
4.8-20210112-windowsservercore-2004, 4.8-windowsservercore-2004, 4.8, latest	Dockerfile
3.5-20210112-windowsservercore-2004, 3.5-windowsservercore-2004, 3.5	Dockerfile

Windows Server Core, version 1909 amd64 Tags

Tag	Dockerfile
4.8-20210113-windowsservercore-1909, 4.8-windowsservercore-1909, 4.8, latest	Dockerfile
3.5-20210113-windowsservercore-1909, 3.5-windowsservercore-1909, 3.5	Dockerfile

Windows Server Core 2019 amd64 Tags

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

Windows Server Core 2016 amd64 Tags

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

You can retrieve a list of all available tags for dotnet/framework/runtime at https://mcr.microsoft.com/v2/dotnet/framework/runtime/tags/list.

Version Compatibility

Version Tag	OS Version	Supported .NET Versions
4.8	windowsservercore-20H2, windowsservercore-2004, windowsservercore-1909, 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-20H2, windowsservercore-2004, windowsservercore-1909	4.8, 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

Support

See the .NET Framework Lifecycle FAQ

Image Update Policy

• We update the supported .NET Framework images within 12 hours of any updates to their base images (e.g. windows/servercore:1909, windows/servercore:ltsc2019, 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

• Legal Notice: Container License Information

The .NET Framework images use the same license as the Windows Server Core base image.