README.samples.md

Featured Tags

• dotnetapp (Dockerfile)
  • docker pull mcr.microsoft.com/dotnet/samples:dotnetapp
• aspnetapp (Dockerfile)
  • docker pull mcr.microsoft.com/dotnet/samples:aspnetapp

About

These images contain sample .NET and ASP.NET Core applications.

Watch discussions for Docker-related .NET announcements.

Usage

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

Container sample: Run a simple application

You can quickly run a container with a pre-built .NET Docker image, based on the .NET console sample.

Type the following command to run a sample console application:

docker run --rm mcr.microsoft.com/dotnet/samples

Container sample: Run a web application

You can quickly run a container with a pre-built .NET Docker image, based on the ASP.NET Core sample.

Type the following command to run a sample web application:

docker run -it --rm -p 8000:80 --name aspnetcore_sample mcr.microsoft.com/dotnet/samples:aspnetapp

After the application starts, navigate to http://localhost:8000 in your web browser.

See Hosting ASP.NET Core Images with Docker over HTTPS to use HTTPS with this image.

Related Repos

.NET:

• dotnet: .NET
• dotnet/sdk: .NET SDK
• dotnet/aspnet: ASP.NET Core Runtime
• dotnet/runtime: .NET Runtime
• dotnet/runtime-deps: .NET Runtime Dependencies
• dotnet/monitor: .NET Monitor Tool

.NET Framework:

• dotnet/framework: .NET Framework, ASP.NET and WCF
• dotnet/framework/samples: .NET Framework, ASP.NET and WCF Samples

Full Tag Listing

Linux amd64 Tags

Tags	Dockerfile	OS Version
dotnetapp-buster-slim-amd64, dotnetapp, latest	Dockerfile	Debian 10
aspnetapp-buster-slim-amd64, aspnetapp	Dockerfile	Debian 10

Linux arm32 Tags

Tags	Dockerfile	OS Version
dotnetapp-buster-slim-arm32v7, dotnetapp, latest	Dockerfile	Debian 10
aspnetapp-buster-slim-arm32v7, aspnetapp	Dockerfile	Debian 10

Linux arm64 Tags

Tags	Dockerfile	OS Version
dotnetapp-buster-slim-arm64v8, dotnetapp, latest	Dockerfile	Debian 10
aspnetapp-buster-slim-arm64v8, aspnetapp	Dockerfile	Debian 10

Nano Server 2022 amd64 Tags

Tag	Dockerfile
dotnetapp-nanoserver-ltsc2022, dotnetapp, latest	Dockerfile
aspnetapp-nanoserver-ltsc2022, aspnetapp	Dockerfile

Nano Server, version 1809 amd64 Tags

Tag	Dockerfile
dotnetapp-nanoserver-1809, dotnetapp, latest	Dockerfile
aspnetapp-nanoserver-1809, aspnetapp	Dockerfile

You can retrieve a list of all available tags for dotnet/samples at https://mcr.microsoft.com/v2/dotnet/samples/tags/list.

For tags contained in the old dotnet/core/samples repository, you can retrieve a list of those tags at https://mcr.microsoft.com/v2/dotnet/core/samples/tags/list.

Tags not listed in the table above are not supported. See the Supported Tags Policy

Support

Lifecycle

• Microsoft Support for .NET
• Supported Container Platforms Policy
• Supported Tags Policy

Image Update Policy

• We update the supported .NET images within 12 hours of any updates to their base images (e.g. debian:buster-slim, windows/nanoserver:ltsc2022, buildpack-deps:bionic-scm, etc.).
• We publish .NET images as part of releasing new versions of .NET including major/minor and servicing.

Feedback

• File an issue
• Contact Microsoft Support

License

• Legal Notice: Container License Information
• .NET license
• Discover licensing for Linux image contents
• Windows base image license (only applies to Windows containers)
• Pricing and licensing for Windows Server 2019