README.runtime.md

Important: Client Firewall Rules Update to Microsoft Container Registry (MCR)

To provide a consistent FQDNs, on March 3, 2020 the data endpoint will be changing from *.cdn.mscr.io to *.data.microsoft.com.

For more info, see MCR Client Firewall Rules.

Featured Tags

• 3.1 (LTS/Current)
  • docker pull mcr.microsoft.com/dotnet/core/runtime:3.1

About This Image

This image contains the .NET Core runtimes and libraries and is optimized for running .NET Core apps in production.

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

How to Use the Image

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

Container sample: Run a simple application

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

Type the following command to run a sample console application:

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

Related Repos

.NET Core:

• dotnet/core: .NET Core
• dotnet/core/sdk: .NET Core SDK
• dotnet/core/aspnet: ASP.NET Core Runtime
• dotnet/core/runtime-deps: .NET Core Runtime Dependencies
• dotnet/core/samples: .NET Core Samples
• dotnet/core-nightly: .NET Core (Preview)

.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
3.1.2-buster-slim, 3.1-buster-slim, 3.1.2, 3.1, latest	Dockerfile	Debian 10
3.1.2-alpine3.11, 3.1-alpine3.11, 3.1.2-alpine, 3.1-alpine	Dockerfile	Alpine 3.11
3.1.2-alpine3.10, 3.1-alpine3.10	Dockerfile	Alpine 3.10
3.1.2-bionic, 3.1-bionic	Dockerfile	Ubuntu 18.04
3.0.3-buster-slim, 3.0-buster-slim, 3.0.3, 3.0	Dockerfile	Debian 10
3.0.3-alpine3.11, 3.0-alpine3.11, 3.0.3-alpine, 3.0-alpine	Dockerfile	Alpine 3.11
3.0.3-alpine3.10, 3.0-alpine3.10	Dockerfile	Alpine 3.10
3.0.3-bionic, 3.0-bionic	Dockerfile	Ubuntu 18.04
2.1.16-stretch-slim, 2.1-stretch-slim, 2.1.16, 2.1	Dockerfile	Debian 9
2.1.16-alpine3.11, 2.1-alpine3.11, 2.1.16-alpine, 2.1-alpine	Dockerfile	Alpine 3.11
2.1.16-alpine3.10, 2.1-alpine3.10	Dockerfile	Alpine 3.10
2.1.16-bionic, 2.1-bionic	Dockerfile	Ubuntu 18.04

Linux arm64 Tags

Tags	Dockerfile	OS Version
3.1.2-buster-slim-arm64v8, 3.1-buster-slim-arm64v8, 3.1.2, 3.1, latest	Dockerfile	Debian 10
3.1.2-alpine3.11-arm64v8, 3.1-alpine3.11-arm64v8, 3.1.2-alpine-arm64v8, 3.1-alpine-arm64v8	Dockerfile	Alpine 3.11
3.1.2-alpine3.10-arm64v8, 3.1-alpine3.10-arm64v8	Dockerfile	Alpine 3.10
3.1.2-bionic-arm64v8, 3.1-bionic-arm64v8	Dockerfile	Ubuntu 18.04
3.0.3-buster-slim-arm64v8, 3.0-buster-slim-arm64v8, 3.0.3, 3.0	Dockerfile	Debian 10
3.0.3-alpine3.11-arm64v8, 3.0-alpine3.11-arm64v8, 3.0.3-alpine-arm64v8, 3.0-alpine-arm64v8	Dockerfile	Alpine 3.11
3.0.3-alpine3.10-arm64v8, 3.0-alpine3.10-arm64v8	Dockerfile	Alpine 3.10
3.0.3-bionic-arm64v8, 3.0-bionic-arm64v8	Dockerfile	Ubuntu 18.04

Linux arm32 Tags

Tags	Dockerfile	OS Version
3.1.2-buster-slim-arm32v7, 3.1-buster-slim-arm32v7, 3.1.2, 3.1, latest	Dockerfile	Debian 10
3.1.2-bionic-arm32v7, 3.1-bionic-arm32v7	Dockerfile	Ubuntu 18.04
3.0.3-buster-slim-arm32v7, 3.0-buster-slim-arm32v7, 3.0.3, 3.0	Dockerfile	Debian 10
3.0.3-bionic-arm32v7, 3.0-bionic-arm32v7	Dockerfile	Ubuntu 18.04
2.1.16-stretch-slim-arm32v7, 2.1-stretch-slim-arm32v7, 2.1.16, 2.1	Dockerfile	Debian 9
2.1.16-bionic-arm32v7, 2.1-bionic-arm32v7	Dockerfile	Ubuntu 18.04

Windows Server, version 1909 amd64 Tags

Tag	Dockerfile
3.1.2-nanoserver-1909, 3.1-nanoserver-1909, 3.1.2, 3.1, latest	Dockerfile
3.0.3-nanoserver-1909, 3.0-nanoserver-1909, 3.0.3, 3.0	Dockerfile
2.1.16-nanoserver-1909, 2.1-nanoserver-1909, 2.1.16, 2.1	Dockerfile

Windows Server, version 1903 amd64 Tags

Tag	Dockerfile
3.1.2-nanoserver-1903, 3.1-nanoserver-1903, 3.1.2, 3.1, latest	Dockerfile
3.0.3-nanoserver-1903, 3.0-nanoserver-1903, 3.0.3, 3.0	Dockerfile
2.1.16-nanoserver-1903, 2.1-nanoserver-1903, 2.1.16, 2.1	Dockerfile

Windows Server 2019 amd64 Tags

Tag	Dockerfile
3.1.2-nanoserver-1809, 3.1-nanoserver-1809, 3.1.2, 3.1, latest	Dockerfile
3.0.3-nanoserver-1809, 3.0-nanoserver-1809, 3.0.3, 3.0	Dockerfile
2.1.16-nanoserver-1809, 2.1-nanoserver-1809, 2.1.16, 2.1	Dockerfile

Windows Server 2019 arm32 Tags

Tag	Dockerfile
3.1.2-nanoserver-1809-arm32v7, 3.1-nanoserver-1809-arm32v7, 3.1.2, 3.1, latest	Dockerfile
3.0.3-nanoserver-1809-arm32v7, 3.0-nanoserver-1809-arm32v7, 3.0.3, 3.0	Dockerfile

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

Support

See Microsoft Support for .NET Core for the support lifecycle.

Image Update Policy

• We update the supported .NET Core 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 Core images as part of releasing new versions of .NET Core including major/minor and servicing.

Feedback

• File a .NET Core Docker issue
• File a .NET Core 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

License

• .NET Core license
• Discover licensing for Linux image contents
• Windows Nano Server license (only applies to Windows containers)
• Pricing and licensing for Windows Server 2019