Latest Version of Common Tags

The following tags are the latest stable versions of the most commonly used images. The complete set of tags is listed further down.

• 4.7.2-runtime
• 4.7.2-sdk
• 3.5-runtime
• 3.5-sdk

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

Watch dotnet/announcements for Docker-related .NET announcements.

Container sample: Run a simple application

Type the following command to run a sample console application:

docker run --rm microsoft/dotnet-framework-samples

Container sample: Run a web application

Type the following command to run a sample web application:

docker run -it --rm -p 8000:80 --name aspnet_sample microsoft/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.

Complete set of Tags

Windows Server, version 1803 amd64 tags

• 4.7.2-runtime-20180814-windowsservercore-1803, 4.7.2-runtime-windowsservercore-1803, 4.7.2-runtime, runtime, latest (4.7.2-windowsservercore-1803/runtime/Dockerfile)
• 4.7.2-sdk-20180814-windowsservercore-1803, 4.7.2-sdk-windowsservercore-1803, 4.7.2-sdk, sdk (4.7.2-windowsservercore-1803/sdk/Dockerfile)
• 3.5-runtime-20180814-windowsservercore-1803, 3.5-runtime-windowsservercore-1803, 3.5-runtime (3.5-windowsservercore-1803/runtime/Dockerfile)
• 3.5-sdk-20180814-windowsservercore-1803, 3.5-sdk-windowsservercore-1803, 3.5-sdk (3.5-windowsservercore-1803/sdk/Dockerfile)

Windows Server, version 1709 amd64 tags

• 4.7.2-runtime-20180814-windowsservercore-1709, 4.7.2-runtime-windowsservercore-1709, 4.7.2-runtime, runtime, latest (4.7.2-windowsservercore-1709/runtime/Dockerfile)
• 4.7.2-sdk-20180814-windowsservercore-1709, 4.7.2-sdk-windowsservercore-1709, 4.7.2-sdk, sdk (4.7.2-windowsservercore-1709/sdk/Dockerfile)
• 4.7.1-runtime-20180814-windowsservercore-1709, 4.7.1-runtime-windowsservercore-1709, 4.7.1-runtime (4.7.1-windowsservercore-1709/runtime/Dockerfile)
• 4.7.1-sdk-20180814-windowsservercore-1709, 4.7.1-sdk-windowsservercore-1709, 4.7.1-sdk (4.7.1-windowsservercore-1709/sdk/Dockerfile)
• 3.5-runtime-20180814-windowsservercore-1709, 3.5-runtime-windowsservercore-1709, 3.5-runtime (3.5-windowsservercore-1709/runtime/Dockerfile)
• 3.5-sdk-20180814-windowsservercore-1709, 3.5-sdk-windowsservercore-1709, 3.5-sdk (3.5-windowsservercore-1709/sdk/Dockerfile)

Windows Server 2016 amd64 tags

• 4.7.2-runtime-20180814-windowsservercore-ltsc2016, 4.7.2-runtime-windowsservercore-ltsc2016, 4.7.2-runtime, runtime, latest (4.7.2-windowsservercore-ltsc2016/runtime/Dockerfile)
• 4.7.2-sdk-20180814-windowsservercore-ltsc2016, 4.7.2-sdk-windowsservercore-ltsc2016, 4.7.2-sdk, sdk (4.7.2-windowsservercore-ltsc2016/sdk/Dockerfile)
• 4.7.1-runtime-20180814-windowsservercore-ltsc2016, 4.7.1-runtime-windowsservercore-ltsc2016, 4.7.1-runtime (4.7.1-windowsservercore-ltsc2016/runtime/Dockerfile)
• 4.7.1-sdk-20180814-windowsservercore-ltsc2016, 4.7.1-sdk-windowsservercore-ltsc2016, 4.7.1-sdk (4.7.1-windowsservercore-ltsc2016/sdk/Dockerfile)
• 4.7-runtime-20180814-windowsservercore-ltsc2016, 4.7-runtime-windowsservercore-ltsc2016, 4.7-runtime (4.7-windowsservercore-ltsc2016/runtime/Dockerfile)
• 4.6.2-runtime-20180814-windowsservercore-ltsc2016, 4.6.2-runtime-windowsservercore-ltsc2016, 4.6.2-runtime (4.6.2-windowsservercore-ltsc2016/runtime/Dockerfile)
• 3.5-runtime-20180814-windowsservercore-ltsc2016, 3.5-runtime-windowsservercore-ltsc2016, 3.5-runtime (3.5-windowsservercore-ltsc2016/runtime/Dockerfile)
• 3.5-sdk-20180814-windowsservercore-ltsc2016, 3.5-sdk-windowsservercore-ltsc2016, 3.5-sdk (3.5-windowsservercore-ltsc2016/sdk/Dockerfile)

For more information about these images and their history, please see (microsoft/dotnet-framework-docker).

What is the .NET Framework?

The .NET Framework is a general purpose development platform maintained by Microsoft. It is the most popular way to build client and server applications for Windows and Windows Server. It is included with Windows, Windows Server and Windows Server Core. It includes server technologies such as ASP.NET Web Forms, ASP.NET MVC and Windows Communication Framework (WCF) applications, which you can run in Docker containers.

.NET has several capabilities that make development easier, including automatic memory management, (runtime) generic types, reflection, asynchrony, concurrency, and native interop. Millions of developers take advantage of these capabilities to efficiently build high-quality web and client applications.

You can use C#, F# and VB to write .NET Framework apps. C# is simple, powerful, type-safe, and object-oriented while retaining the expressiveness and elegance of C-style languages. F# is a multi-paradigm programming language, enabling both functional and object-oriented patterns and practices. VB is a rapid development programming language with the deepest integration between the language and Visual Studio, providing the fastest path to a working app.

The .NET Framework was first released by Microsoft in 2001. The latest version is .NET Framework 4.7.2.

https://docs.microsoft.com/dotnet/framework/

.NET Framework Docker Samples

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.

Image variants

The microsoft/dotnet-framework images come in different flavors, each designed for a specific use case.

4.7.2

This is the primary image. If you are unsure about what your needs are, you probably want to use this one.

This image is for .NET Framework 4.0 and later version applications. It is based on the Windows Server Core image.

4.7, 4.6.2, 4.7.1

These images are for applications that need a specific .NET Framework version and have not been tested with .NET Framework 4.7.2. It is based on the Windows Server Core image.

3.5

This image is for .NET Framework 3.5 and earlier version applications. It is based on the Windows Server Core image.

Issues

If you have any problems with or questions about this image, please contact us through a GitHub issue.

Licenses

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

Related Repositories

.NET Core Docker Hub repos:

• microsoft/aspnetcore for ASP.NET Core images.
• microsoft/dotnet for .NET Core images.
• microsoft/dotnet-nightly for .NET Core preview images.
• microsoft/dotnet-samples for .NET Core sample images.

.NET Framework Docker Hub repos:

• microsoft/aspnet for ASP.NET Web Forms and MVC images.
• microsoft/dotnet-framework for .NET Framework images.
• microsoft/dotnet-framework-samples for .NET Framework and ASP.NET sample images.