README.runtime.md

Important: Client Firewall Rules Update to Microsoft Container Registry (MCR)

To provide a consistent FQDNs, on March 3, 2020 the data endpoint will be changing from *.cdn.mscr.io to *.data.microsoft.com.

For more info, see MCR Client Firewall Rules.

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 Core:

• dotnet/core: .NET Core
• dotnet/core-nightly: .NET Core (Preview)
• dotnet/core/samples: .NET Core Samples

Full Tag Listing

Windows Server, version 1909 amd64 Tags

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

Windows Server, version 1903 amd64 Tags

Tag	Dockerfile
4.8-20200211-windowsservercore-1903, 4.8-windowsservercore-1903, 4.8, latest	Dockerfile
3.5-20200211-windowsservercore-1903, 3.5-windowsservercore-1903, 3.5	Dockerfile

Windows Server 2019 amd64 Tags

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

Windows Server 2016 amd64 Tags

Tag	Dockerfile
4.8-20200211-windowsservercore-ltsc2016, 4.8-windowsservercore-ltsc2016, 4.8, latest	Dockerfile
4.7.2-20200211-windowsservercore-ltsc2016, 4.7.2-windowsservercore-ltsc2016, 4.7.2	Dockerfile
4.7.1-20200211-windowsservercore-ltsc2016, 4.7.1-windowsservercore-ltsc2016, 4.7.1	Dockerfile
4.7-20200211-windowsservercore-ltsc2016, 4.7-windowsservercore-ltsc2016, 4.7	Dockerfile
4.6.2-20200211-windowsservercore-ltsc2016, 4.6.2-windowsservercore-ltsc2016, 4.6.2	Dockerfile
3.5-20200211-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.

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 a .NET Framework Docker issue
• Report a .NET Framework problem
• File a Visual Studio Docker Tools issue
• File a Microsoft Container Registry (MCR) issue
• Ask on Stack Overflow
• Contact Microsoft Support

License

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