README.samples.md

Featured Tags

• dotnetapp
  • docker pull mcr.microsoft.com/dotnet/framework/samples:dotnetapp
• aspnetapp
  • docker pull mcr.microsoft.com/dotnet/framework/samples:aspnetapp
• wcfservice
  • docker pull mcr.microsoft.com/dotnet/framework/samples:wcfservice
• wcfclient
  • docker pull mcr.microsoft.com/dotnet/framework/samples:wcfclient

About This Image

These images contain sample .NET Framework, ASP.NET and WCF applications.

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

How to Use the Image

The .NET Framework Docker samples show various ways to use .NET Framework and Docker together. See Building Docker Images for .NET Framework Applications to learn more.

Container sample: Run a simple application

Type the following command to run a sample console application with Docker:

docker run --rm mcr.microsoft.com/dotnet/framework/samples:dotnetapp

Container sample: Run a web application

Type the following command to run a sample web application with Docker:

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

Container sample: Run WCF service and client applications

Type the following command to run a sample WCF service application with Docker:

docker run -it --rm --name wcfservice_sample mcr.microsoft.com/dotnet/framework/samples:wcfservice

After the container starts, find the IP address of the container instance:

docker inspect --format="{{.NetworkSettings.Networks.nat.IPAddress}}" wcfservice_sample
172.26.236.119

Type the following Docker command to start a WCF client container, set environment variable HOST to the IP address of the wcfservice_sample container:

docker run --name wcfclient_sample --rm -it -e HOST=172.26.236.119 mcr.microsoft.com/dotnet/framework/samples:wcfclient

Related Repos

.NET Framework:

• dotnet/framework/sdk: .NET Framework SDK
• dotnet/framework/aspnet: ASP.NET Web Forms and MVC
• dotnet/framework/runtime: .NET Framework Runtime
• dotnet/framework/wcf: Windows Communication Framework (WCF)

.NET Core:

• dotnet/core: .NET Core
• dotnet/core-nightly: .NET Core (Preview)
• dotnet/core/samples: .NET Core Samples

Full Tag Listing

Windows Server, version 1903 amd64 tags

• dotnetapp-windowsservercore-1903, dotnetapp, latest (Dockerfile)
• aspnetapp-windowsservercore-1903, aspnetapp (Dockerfile)
• wcfservice-windowsservercore-1903, wcfservice (Dockerfile)
• wcfclient-windowsservercore-1903, wcfclient (Dockerfile)

Windows Server 2019 amd64 tags

• dotnetapp-windowsservercore-ltsc2019, dotnetapp, latest (Dockerfile)
• aspnetapp-windowsservercore-ltsc2019, aspnetapp (Dockerfile)
• wcfservice-windowsservercore-ltsc2019, wcfservice (Dockerfile)
• wcfclient-windowsservercore-ltsc2019, wcfclient (Dockerfile)

Windows Server, version 1803 amd64 tags

• dotnetapp-windowsservercore-1803, dotnetapp, latest (Dockerfile)
• aspnetapp-windowsservercore-1803, aspnetapp (Dockerfile)
• wcfservice-windowsservercore-1803, wcfservice (Dockerfile)
• wcfclient-windowsservercore-1803, wcfclient (Dockerfile)

Windows Server 2016 amd64 tags

• dotnetapp-windowsservercore-ltsc2016, dotnetapp, latest (Dockerfile)
• aspnetapp-windowsservercore-ltsc2016, aspnetapp (Dockerfile)
• wcfservice-windowsservercore-ltsc2016, wcfservice (Dockerfile)
• wcfclient-windowsservercore-ltsc2016, wcfclient (Dockerfile)

Support

See the .NET Framework Lifecycle FAQ

Feedback

• File a .NET Framework Docker issue
• Report a .NET Framework problem
• Ask on Stack Overflow
• Contact Microsoft Support

License

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