.NET Framework SDK

Featured tags

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

About

This image contains the .NET Framework SDK which is comprised of the following parts:

1. .NET Framework Runtime
2. Visual Studio Build Tools
3. NuGet CLI
4. .NET Framework Targeting Packs
5. ASP.NET Web Targets

Use this image for your development process (developing, building and testing applications).

Watch discussions for Docker-related .NET announcements.

Usage

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

Building .NET Framework Apps with Docker

• .NET Framework Console Docker Sample - This sample builds, tests, and runs the sample. It includes and builds multiple projects.
• ASP.NET Web Forms Docker Sample - This sample demonstrates using Docker with an ASP.NET Web Forms app.
• ASP.NET MVC Docker Sample - This sample demonstrates using Docker with an ASP.NET MVC app.
• WCF Docker Sample - This sample demonstrates using Docker with a WCF app.

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 migration guide
• Application compatibility in .NET Framework.
• Version compatibility in .NET Framework

Related repositories

.NET Framework:

• dotnet/framework: .NET Framework
• dotnet/framework/aspnet: ASP.NET Web Forms and MVC
• dotnet/framework/runtime: .NET Framework Runtime
• 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 amd64 Tags

Tags	Dockerfile	OS Version
4.8.1-20260609-windowsservercore-ltsc2025, 4.8.1-windowsservercore-ltsc2025, 4.8.1	Dockerfile	Windows Server Core 2025
4.8.1-20260609-windowsservercore-ltsc2022, 4.8.1-windowsservercore-ltsc2022, 4.8.1	Dockerfile	Windows Server Core 2022
4.8-20260609-windowsservercore-ltsc2019, 4.8-windowsservercore-ltsc2019, 4.8, latest	Dockerfile	Windows Server Core 2019
4.8-20260609-windowsservercore-ltsc2016, 4.8-windowsservercore-ltsc2016, 4.8, latest	Dockerfile	Windows 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

• .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