.NET Framework, ASP.NET and WCF Samples

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

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

Watch discussions for Docker-related .NET announcements.

Usage

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

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 repositories

.NET Framework:

dotnet/framework: .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 Foundation (WCF)

.NET:

dotnet: .NET
dotnet/samples: .NET Samples

Full Tag Listing

Windows Server Core 2022 amd64 Tags

Tag	Dockerfile
dotnetapp-windowsservercore-ltsc2022, dotnetapp, latest	Dockerfile
aspnetapp-windowsservercore-ltsc2022, aspnetapp	Dockerfile
wcfservice-windowsservercore-ltsc2022, wcfservice	Dockerfile
wcfclient-windowsservercore-ltsc2022, wcfclient	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

These sample images are not intended for production use and may be subject to breaking changes or removal at any time. They are provided as a starting point for developers to experiment with and learn about .NET Framework in a containerized environment.

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
Windows Base Image License: applies to all .NET Framework container images
Visual Studio Tools License: applies to all .NET Framework SDK container images

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!