4.8.1docker pull mcr.microsoft.com/dotnet/framework/runtime:4.8.1
4.8docker pull mcr.microsoft.com/dotnet/framework/runtime:4.8
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.
The .NET Framework Docker samples show various ways to use .NET Framework and Docker together.
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:dotnetappIf 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
.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
| Tags | Dockerfile | OS Version |
|---|---|---|
| 4.8.1-20251014-windowsservercore-ltsc2025, 4.8.1-windowsservercore-ltsc2025, 4.8.1 | Dockerfile | Windows Server Core 2025 |
| 4.8.1-20251014-windowsservercore-ltsc2022, 4.8.1-windowsservercore-ltsc2022, 4.8.1 | Dockerfile | Windows Server Core 2022 |
| 4.8-20251014-windowsservercore-ltsc2019, 4.8-windowsservercore-ltsc2019, 4.8, latest | Dockerfile | Windows Server Core 2019 |
| 4.8-20251014-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.
- 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.
- 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