# ASP.NET Web Forms and MVC ## Featured tags * `4.8.1` * `docker pull mcr.microsoft.com/dotnet/framework/aspnet:4.8.1` * `4.8` * `docker pull mcr.microsoft.com/dotnet/framework/aspnet:4.8` ## About ASP.NET is a high productivity framework for building Web Applications using Web Forms, MVC, Web API and SignalR. This image contains: * Windows Server Core as the base OS * IIS 10 as Web Server * .NET Framework (multiple versions available) * .NET Extensibility for IIS Watch [discussions](https://github.com/microsoft/dotnet-framework-docker/discussions/categories/announcements) for Docker-related .NET announcements. ## Usage The [.NET Framework Docker samples](https://github.com/microsoft/dotnet-framework-docker/blob/main/samples/README.md) show various ways to use .NET Framework and Docker together. ### Container sample: Run an ASP.NET application You can quickly run a container with a pre-built [sample ASP.NET Docker image](https://github.com/microsoft/dotnet-framework-docker/blob/main/README.samples.md), based on the [ASP.NET Docker sample]. Type the following [Docker](https://www.docker.com/products/docker) command: ```console docker run --name aspnet_sample --rm -it -p 8000:80 mcr.microsoft.com/dotnet/framework/samples:aspnetapp ``` After the application starts, navigate to `http://localhost:8000` in your web browser. You need to navigate to the application via IP address instead of `localhost` for earlier Windows versions, which is demonstrated in [View the ASP.NET app in a running container on Windows](https://github.com/microsoft/dotnet-framework-docker/blob/main/samples/aspnetapp/README.md#view-the-aspnet-app-in-a-running-container-on-windows). ### 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](https://learn.microsoft.com/en-us/dotnet/framework/migration-guide/) * [Application compatibility in .NET Framework](https://learn.microsoft.com/dotnet/framework/migration-guide/application-compatibility). * [Version compatibility in .NET Framework](https://learn.microsoft.com/dotnet/framework/migration-guide/version-compatibility) ## Related repositories .NET Framework: * [dotnet/framework](https://github.com/microsoft/dotnet-framework-docker/blob/main/README.md): .NET Framework * [dotnet/framework/sdk](https://github.com/microsoft/dotnet-framework-docker/blob/main/README.sdk.md): .NET Framework SDK * [dotnet/framework/runtime](https://github.com/microsoft/dotnet-framework-docker/blob/main/README.runtime.md): .NET Framework Runtime * [dotnet/framework/wcf](https://github.com/microsoft/dotnet-framework-docker/blob/main/README.wcf.md): Windows Communication Foundation (WCF) * [dotnet/framework/samples](https://github.com/microsoft/dotnet-framework-docker/blob/main/README.samples.md): .NET Framework, ASP.NET and WCF Samples .NET: * [dotnet](https://github.com/dotnet/dotnet-docker/blob/main/README.md): .NET * [dotnet/samples](https://github.com/dotnet/dotnet-docker/blob/main/README.samples.md): .NET Samples ## Full Tag Listing ### Windows amd64 Tags Tags | Dockerfile | OS Version ---- | ---------- | ---------- 4.8.1-20260908-windowsservercore-ltsc2025, 4.8.1-windowsservercore-ltsc2025, 4.8.1 | [Dockerfile](src/aspnet/4.8.1/windowsservercore-ltsc2025/Dockerfile) | Windows Server Core 2025 4.8.1-20260908-windowsservercore-ltsc2022, 4.8.1-windowsservercore-ltsc2022, 4.8.1 | [Dockerfile](src/aspnet/4.8.1/windowsservercore-ltsc2022/Dockerfile) | Windows Server Core 2022 4.8-20260908-windowsservercore-ltsc2019, 4.8-windowsservercore-ltsc2019, 4.8, latest | [Dockerfile](src/aspnet/4.8/windowsservercore-ltsc2019/Dockerfile) | Windows Server Core 2019 4.8-20260908-windowsservercore-ltsc2016, 4.8-windowsservercore-ltsc2016, 4.8, latest | [Dockerfile](src/aspnet/4.8/windowsservercore-ltsc2016/Dockerfile) | Windows Server Core 2016 *Tags not listed in the table above are not supported. See the [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md). See the [full list of tags](https://mcr.microsoft.com/v2/dotnet/framework/aspnet/tags/list) for all supported and unsupported tags.* ## Support ### Lifecycle * [.NET Framework Lifecycle FAQ](https://support.microsoft.com/help/17455/lifecycle-faq-net-framework) * [Supported Tags Policy](https://github.com/microsoft/dotnet-framework-docker/blob/main/documentation/supported-tags.md) ### 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](https://github.com/microsoft/dotnet-framework-docker/issues/new/choose) * [Contact Microsoft Support](https://support.microsoft.com/contactus/) ## License * [Microsoft Container Images Legal Notice](https://aka.ms/mcr/osslegalnotice): applies to all [.NET Framework container images](https://github.com/microsoft/dotnet-framework-docker/blob/main/README.md) * [Windows Base Image License](https://learn.microsoft.com/virtualization/windowscontainers/images-eula): applies to all [.NET Framework container images](https://github.com/microsoft/dotnet-framework-docker/blob/main/README.md) * [Visual Studio Tools License](https://visualstudio.microsoft.com/license-terms/mlt031519/): applies to all [.NET Framework SDK container images](https://github.com/microsoft/dotnet-framework-docker/blob/main/README.sdk.md)