README.runtime.md

Featured Tags

• 7.0 (Standard Support)
  • docker pull mcr.microsoft.com/dotnet/runtime:7.0
• 6.0 (Long-Term Support)
  • docker pull mcr.microsoft.com/dotnet/runtime:6.0

About

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

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

Related Repositories

.NET:

• dotnet: .NET
• dotnet/sdk: .NET SDK
• dotnet/aspnet: ASP.NET Core Runtime
• dotnet/runtime-deps: .NET Runtime Dependencies
• dotnet/monitor: .NET Monitor Tool
• dotnet/samples: .NET Samples
• dotnet/nightly/runtime: .NET Runtime (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
7.0.7-bullseye-slim-amd64, 7.0-bullseye-slim-amd64, 7.0.7-bullseye-slim, 7.0-bullseye-slim, 7.0.7, 7.0, latest	Dockerfile	Debian 11
7.0.7-alpine3.18-amd64, 7.0-alpine3.18-amd64, 7.0.7-alpine3.18, 7.0-alpine3.18	Dockerfile	Alpine 3.18
7.0.7-alpine3.17-amd64, 7.0-alpine3.17-amd64, 7.0-alpine-amd64, 7.0.7-alpine3.17, 7.0-alpine3.17, 7.0-alpine	Dockerfile	Alpine 3.17
7.0.7-jammy-amd64, 7.0-jammy-amd64, 7.0.7-jammy, 7.0-jammy	Dockerfile	Ubuntu 22.04
6.0.18-bullseye-slim-amd64, 6.0-bullseye-slim-amd64, 6.0.18-bullseye-slim, 6.0-bullseye-slim, 6.0.18, 6.0	Dockerfile	Debian 11
6.0.18-alpine3.18-amd64, 6.0-alpine3.18-amd64, 6.0.18-alpine3.18, 6.0-alpine3.18	Dockerfile	Alpine 3.18
6.0.18-alpine3.17-amd64, 6.0-alpine3.17-amd64, 6.0-alpine-amd64, 6.0.18-alpine3.17, 6.0-alpine3.17, 6.0-alpine	Dockerfile	Alpine 3.17
6.0.18-jammy-amd64, 6.0-jammy-amd64, 6.0.18-jammy, 6.0-jammy	Dockerfile	Ubuntu 22.04
6.0.18-focal-amd64, 6.0-focal-amd64, 6.0.18-focal, 6.0-focal	Dockerfile	Ubuntu 20.04

.NET 8 Preview Tags

Tags	Dockerfile	OS Version
8.0.0-preview.5-bookworm-slim-amd64, 8.0-preview-bookworm-slim-amd64, 8.0.0-preview.5-bookworm-slim, 8.0-preview-bookworm-slim, 8.0.0-preview.5, 8.0-preview	Dockerfile	Debian 12
8.0.0-preview.5-alpine3.18-amd64, 8.0-preview-alpine3.18-amd64, 8.0-preview-alpine-amd64, 8.0.0-preview.5-alpine3.18, 8.0-preview-alpine3.18, 8.0-preview-alpine	Dockerfile	Alpine 3.18
8.0.0-preview.5-jammy-amd64, 8.0-preview-jammy-amd64, 8.0.0-preview.5-jammy, 8.0-preview-jammy	Dockerfile	Ubuntu 22.04
8.0.0-preview.5-jammy-chiseled-amd64, 8.0-preview-jammy-chiseled-amd64, 8.0.0-preview.5-jammy-chiseled, 8.0-preview-jammy-chiseled	Dockerfile	Ubuntu 22.04

Linux arm64 Tags

Tags	Dockerfile	OS Version
7.0.7-bullseye-slim-arm64v8, 7.0-bullseye-slim-arm64v8, 7.0.7-bullseye-slim, 7.0-bullseye-slim, 7.0.7, 7.0, latest	Dockerfile	Debian 11
7.0.7-alpine3.18-arm64v8, 7.0-alpine3.18-arm64v8, 7.0.7-alpine3.18, 7.0-alpine3.18	Dockerfile	Alpine 3.18
7.0.7-alpine3.17-arm64v8, 7.0-alpine3.17-arm64v8, 7.0-alpine-arm64v8, 7.0.7-alpine3.17, 7.0-alpine3.17, 7.0-alpine	Dockerfile	Alpine 3.17
7.0.7-jammy-arm64v8, 7.0-jammy-arm64v8, 7.0.7-jammy, 7.0-jammy	Dockerfile	Ubuntu 22.04
6.0.18-bullseye-slim-arm64v8, 6.0-bullseye-slim-arm64v8, 6.0.18-bullseye-slim, 6.0-bullseye-slim, 6.0.18, 6.0	Dockerfile	Debian 11
6.0.18-alpine3.18-arm64v8, 6.0-alpine3.18-arm64v8, 6.0.18-alpine3.18, 6.0-alpine3.18	Dockerfile	Alpine 3.18
6.0.18-alpine3.17-arm64v8, 6.0-alpine3.17-arm64v8, 6.0-alpine-arm64v8, 6.0.18-alpine3.17, 6.0-alpine3.17, 6.0-alpine	Dockerfile	Alpine 3.17
6.0.18-jammy-arm64v8, 6.0-jammy-arm64v8, 6.0.18-jammy, 6.0-jammy	Dockerfile	Ubuntu 22.04
6.0.18-focal-arm64v8, 6.0-focal-arm64v8, 6.0.18-focal, 6.0-focal	Dockerfile	Ubuntu 20.04

.NET 8 Preview Tags

Tags	Dockerfile	OS Version
8.0.0-preview.5-bookworm-slim-arm64v8, 8.0-preview-bookworm-slim-arm64v8, 8.0.0-preview.5-bookworm-slim, 8.0-preview-bookworm-slim, 8.0.0-preview.5, 8.0-preview	Dockerfile	Debian 12
8.0.0-preview.5-alpine3.18-arm64v8, 8.0-preview-alpine3.18-arm64v8, 8.0-preview-alpine-arm64v8, 8.0.0-preview.5-alpine3.18, 8.0-preview-alpine3.18, 8.0-preview-alpine	Dockerfile	Alpine 3.18
8.0.0-preview.5-jammy-arm64v8, 8.0-preview-jammy-arm64v8, 8.0.0-preview.5-jammy, 8.0-preview-jammy	Dockerfile	Ubuntu 22.04
8.0.0-preview.5-jammy-chiseled-arm64v8, 8.0-preview-jammy-chiseled-arm64v8, 8.0.0-preview.5-jammy-chiseled, 8.0-preview-jammy-chiseled	Dockerfile	Ubuntu 22.04

Linux arm32 Tags

Tags	Dockerfile	OS Version
7.0.7-bullseye-slim-arm32v7, 7.0-bullseye-slim-arm32v7, 7.0.7-bullseye-slim, 7.0-bullseye-slim, 7.0.7, 7.0, latest	Dockerfile	Debian 11
7.0.7-alpine3.18-arm32v7, 7.0-alpine3.18-arm32v7, 7.0.7-alpine3.18, 7.0-alpine3.18	Dockerfile	Alpine 3.18
7.0.7-alpine3.17-arm32v7, 7.0-alpine3.17-arm32v7, 7.0-alpine-arm32v7, 7.0.7-alpine3.17, 7.0-alpine3.17, 7.0-alpine	Dockerfile	Alpine 3.17
7.0.7-jammy-arm32v7, 7.0-jammy-arm32v7, 7.0.7-jammy, 7.0-jammy	Dockerfile	Ubuntu 22.04
6.0.18-bullseye-slim-arm32v7, 6.0-bullseye-slim-arm32v7, 6.0.18-bullseye-slim, 6.0-bullseye-slim, 6.0.18, 6.0	Dockerfile	Debian 11
6.0.18-alpine3.18-arm32v7, 6.0-alpine3.18-arm32v7, 6.0.18-alpine3.18, 6.0-alpine3.18	Dockerfile	Alpine 3.18
6.0.18-alpine3.17-arm32v7, 6.0-alpine3.17-arm32v7, 6.0-alpine-arm32v7, 6.0.18-alpine3.17, 6.0-alpine3.17, 6.0-alpine	Dockerfile	Alpine 3.17
6.0.18-jammy-arm32v7, 6.0-jammy-arm32v7, 6.0.18-jammy, 6.0-jammy	Dockerfile	Ubuntu 22.04
6.0.18-focal-arm32v7, 6.0-focal-arm32v7, 6.0.18-focal, 6.0-focal	Dockerfile	Ubuntu 20.04

.NET 8 Preview Tags

Tags	Dockerfile	OS Version
8.0.0-preview.5-bookworm-slim-arm32v7, 8.0-preview-bookworm-slim-arm32v7, 8.0.0-preview.5-bookworm-slim, 8.0-preview-bookworm-slim, 8.0.0-preview.5, 8.0-preview	Dockerfile	Debian 12
8.0.0-preview.5-alpine3.18-arm32v7, 8.0-preview-alpine3.18-arm32v7, 8.0-preview-alpine-arm32v7, 8.0.0-preview.5-alpine3.18, 8.0-preview-alpine3.18, 8.0-preview-alpine	Dockerfile	Alpine 3.18
8.0.0-preview.5-jammy-arm32v7, 8.0-preview-jammy-arm32v7, 8.0.0-preview.5-jammy, 8.0-preview-jammy	Dockerfile	Ubuntu 22.04
8.0.0-preview.5-jammy-chiseled-arm32v7, 8.0-preview-jammy-chiseled-arm32v7, 8.0.0-preview.5-jammy-chiseled, 8.0-preview-jammy-chiseled	Dockerfile	Ubuntu 22.04

Nano Server 2022 amd64 Tags

Tag	Dockerfile
7.0.7-nanoserver-ltsc2022, 7.0-nanoserver-ltsc2022, 7.0.7, 7.0, latest	Dockerfile
6.0.18-nanoserver-ltsc2022, 6.0-nanoserver-ltsc2022, 6.0.18, 6.0	Dockerfile

.NET 8 Preview Tags

Tag	Dockerfile
8.0.0-preview.5-nanoserver-ltsc2022, 8.0-preview-nanoserver-ltsc2022	Dockerfile

Windows Server Core 2022 amd64 Tags

Tag	Dockerfile
7.0.7-windowsservercore-ltsc2022, 7.0-windowsservercore-ltsc2022	Dockerfile
6.0.18-windowsservercore-ltsc2022, 6.0-windowsservercore-ltsc2022	Dockerfile

.NET 8 Preview Tags

Tag	Dockerfile
8.0.0-preview.5-windowsservercore-ltsc2022, 8.0-preview-windowsservercore-ltsc2022	Dockerfile

Nano Server, version 1809 amd64 Tags

Tag	Dockerfile
7.0.7-nanoserver-1809, 7.0-nanoserver-1809, 7.0.7, 7.0, latest	Dockerfile
6.0.18-nanoserver-1809, 6.0-nanoserver-1809, 6.0.18, 6.0	Dockerfile

.NET 8 Preview Tags

Tag	Dockerfile
8.0.0-preview.5-nanoserver-1809, 8.0-preview-nanoserver-1809	Dockerfile

Windows Server Core 2019 amd64 Tags

Tag	Dockerfile
7.0.7-windowsservercore-ltsc2019, 7.0-windowsservercore-ltsc2019	Dockerfile
6.0.18-windowsservercore-ltsc2019, 6.0-windowsservercore-ltsc2019	Dockerfile

.NET 8 Preview Tags

Tag	Dockerfile
8.0.0-preview.5-windowsservercore-ltsc2019, 8.0-preview-windowsservercore-ltsc2019	Dockerfile

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

For tags contained in the old dotnet/core/runtime repository, you can retrieve a list of those tags at https://mcr.microsoft.com/v2/dotnet/core/runtime/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