README.sdk.md

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

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. Visual Studio Test Agent
4. NuGet CLI
5. .NET Framework Targeting Packs
6. 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

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

* The 4.8 and 4.8.1 SDKs are also capable of building 4.8.1, 4.8, 4.7.2, 4.7.1, 4.7, and 4.6.2 projects.

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 Server Core 2022 amd64 Tags

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

Windows Server Core 2019 amd64 Tags

Tag	Dockerfile
4.8-20240910-windowsservercore-ltsc2019, 4.8-windowsservercore-ltsc2019, 4.8, latest	Dockerfile
3.5-20240910-windowsservercore-ltsc2019, 3.5-windowsservercore-ltsc2019, 3.5	Dockerfile

Windows Server Core 2016 amd64 Tags

Tag	Dockerfile
4.8-20240910-windowsservercore-ltsc2016, 4.8-windowsservercore-ltsc2016, 4.8, latest	Dockerfile
3.5-20240910-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
• Microsoft Software Supplemental License for Windows Container Base Image: applies to all .NET Framework container images
• Visual Studio Tools License: applies to all .NET Framework SDK container images