dotnetapp(Dockerfile)docker pull mcr.microsoft.com/dotnet/samples:dotnetapp
aspnetapp(Dockerfile)docker pull mcr.microsoft.com/dotnet/samples:aspnetapp
These images contain sample .NET and ASP.NET Core applications.
Watch discussions for Docker-related .NET announcements.
The .NET Docker samples show various ways to use .NET and Docker together. See Building Docker Images for .NET Applications to learn more.
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/samplesYou 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:aspnetappAfter 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.
.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
| Tags | Dockerfile | OS Version |
|---|---|---|
| dotnetapp-alpine-slim-amd64, dotnetapp, latest | Dockerfile | Alpine |
| aspnetapp-alpine-slim-amd64, aspnetapp | Dockerfile | Alpine |
| Tags | Dockerfile | OS Version |
|---|---|---|
| dotnetapp-alpine-slim-arm32v7, dotnetapp, latest | Dockerfile | Alpine |
| aspnetapp-alpine-slim-arm32v7, aspnetapp | Dockerfile | Alpine |
| Tags | Dockerfile | OS Version |
|---|---|---|
| dotnetapp-alpine-slim-arm64v8, dotnetapp, latest | Dockerfile | Alpine |
| aspnetapp-alpine-slim-arm64v8, aspnetapp | Dockerfile | Alpine |
| Tag | Dockerfile |
|---|---|
| dotnetapp-nanoserver-ltsc2022, dotnetapp, latest | Dockerfile |
| aspnetapp-nanoserver-ltsc2022, aspnetapp | Dockerfile |
| 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
- 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.
- 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