To provide a consistent FQDNs, the data endpoint will be changing from *.cdn.mscr.io to *.data.mcr.microsoft.com
For more info, see MCR Client Firewall Rules.
The images from the dotnet/nightly repositories include last-known-good (LKG) builds for the next release of .NET.
See dotnet/core for images with official releases of .NET.
As part of the transition to .NET 5.0, Docker repos for .NET 5.0 and higher do not include core
in the name as was done with older versions. As an example, ASP.NET Core 5.0 can be found at mcr.microsoft.com/dotnet/nightly/runtime:5.0
while 3.1 is still at mcr.microsoft.com/dotnet/core-nightly/runtime:3.1
. See the related issue for more details.
5.0
(Preview)docker pull mcr.microsoft.com/dotnet/nightly/runtime:5.0
This image contains the .NET runtimes and libraries and is optimized for running .NET apps in production.
Watch dotnet/announcements 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/core/samples
.NET Core 2.1/3.1:
- dotnet/core: .NET Core
- dotnet/core/samples: .NET Core Samples
.NET 5.0+:
- dotnet: .NET
- dotnet/nightly: .NET (Preview)
- dotnet/nightly/sdk: .NET SDK (Preview)
- dotnet/nightly/aspnet: ASP.NET Core Runtime (Preview)
- dotnet/nightly/runtime-deps: .NET Runtime Dependencies (Preview)
.NET Framework:
- dotnet/framework: .NET Framework, ASP.NET and WCF
- dotnet/framework/samples: .NET Framework, ASP.NET and WCF Samples
Tags | Dockerfile | OS Version |
---|---|---|
5.0.0-preview.3-buster-slim, 5.0-buster-slim, 5.0.0-preview.3, 5.0 | Dockerfile | Debian 10 |
5.0.0-preview.3-alpine3.11, 5.0-alpine3.11, 5.0.0-preview.3-alpine, 5.0-alpine | Dockerfile | Alpine 3.11 |
5.0.0-preview.3-focal, 5.0-focal | Dockerfile | Ubuntu 20.04 |
Tags | Dockerfile | OS Version |
---|---|---|
5.0.0-preview.3-buster-slim-arm64v8, 5.0-buster-slim-arm64v8, 5.0.0-preview.3, 5.0 | Dockerfile | Debian 10 |
5.0.0-preview.3-alpine3.11-arm64v8, 5.0-alpine3.11-arm64v8, 5.0.0-preview.3-alpine-arm64v8, 5.0-alpine-arm64v8 | Dockerfile | Alpine 3.11 |
5.0.0-preview.3-focal-arm64v8, 5.0-focal-arm64v8 | Dockerfile | Ubuntu 20.04 |
Tags | Dockerfile | OS Version |
---|---|---|
5.0.0-preview.3-buster-slim-arm32v7, 5.0-buster-slim-arm32v7, 5.0.0-preview.3, 5.0 | Dockerfile | Debian 10 |
Tag | Dockerfile |
---|---|
5.0.0-preview.3-nanoserver-1909, 5.0-nanoserver-1909, 5.0.0-preview.3, 5.0 | Dockerfile |
Tag | Dockerfile |
---|---|
5.0.0-preview.3-nanoserver-1903, 5.0-nanoserver-1903, 5.0.0-preview.3, 5.0 | Dockerfile |
Tag | Dockerfile |
---|---|
5.0.0-preview.3-nanoserver-1809, 5.0-nanoserver-1809, 5.0.0-preview.3, 5.0 | Dockerfile |
You can retrieve a list of all available tags for dotnet/runtime at https://mcr.microsoft.com/v2/dotnet/runtime/tags/list.
See Microsoft Support for .NET for the support lifecycle.
- We update the supported .NET images within 12 hours of any updates to their base images (e.g. debian:buster-slim, windows/nanoserver:1909, buildpack-deps:bionic-scm, etc.).
- We publish .NET images as part of releasing new versions of .NET including major/minor and servicing.
- File a .NET Docker issue
- File a .NET issue
- File an ASP.NET Core issue
- File an issue for other .NET components
- File a Visual Studio Docker Tools issue
- File a Microsoft Container Registry (MCR) issue
- Ask on Stack Overflow
- Contact Microsoft Support
- .NET license
- Discover licensing for Linux image contents
- Windows Nano Server license (only applies to Windows containers)
- Pricing and licensing for Windows Server 2019