dotnet-docker/README.aspnet.md

IMPORTANT

The images from the dotnet/nightly repositories include last-known-good (LKG) builds for the next release of .NET.

See dotnet for images with official releases of .NET.

Featured Tags

• 7.0 (Preview)
  • docker pull mcr.microsoft.com/dotnet/nightly/aspnet:7.0
• 6.0 (Current, LTS)
  • docker pull mcr.microsoft.com/dotnet/nightly/aspnet:6.0

About

This image contains the ASP.NET Core and .NET runtimes and libraries and is optimized for running ASP.NET Core 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 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/samples: .NET Samples
• dotnet/nightly/sdk: .NET SDK (Preview)
• dotnet/nightly/runtime: .NET Runtime (Preview)
• dotnet/nightly/runtime-deps: .NET Runtime Dependencies (Preview)
• dotnet/nightly/monitor: .NET Monitor Tool (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
6.0.9-bullseye-slim-amd64, 6.0-bullseye-slim-amd64, 6.0.9-bullseye-slim, 6.0-bullseye-slim, 6.0.9, 6.0	Dockerfile	Debian 11
6.0.9-alpine3.16-amd64, 6.0-alpine3.16-amd64, 6.0-alpine-amd64, 6.0.9-alpine3.16, 6.0-alpine3.16, 6.0-alpine	Dockerfile	Alpine 3.16
6.0.9-jammy-amd64, 6.0-jammy-amd64, 6.0.9-jammy, 6.0-jammy	Dockerfile	Ubuntu 22.04
6.0.9-jammy-chiseled-amd64, 6.0-jammy-chiseled-amd64, 6.0.9-jammy-chiseled, 6.0-jammy-chiseled	Dockerfile	Ubuntu 22.04
6.0.9-focal-amd64, 6.0-focal-amd64, 6.0.9-focal, 6.0-focal	Dockerfile	Ubuntu 20.04
3.1.29-bullseye-slim, 3.1-bullseye-slim	Dockerfile	Debian 11
3.1.29-buster-slim, 3.1-buster-slim, 3.1.29, 3.1	Dockerfile	Debian 10
3.1.29-alpine3.16, 3.1-alpine3.16, 3.1-alpine	Dockerfile	Alpine 3.16
3.1.29-focal, 3.1-focal	Dockerfile	Ubuntu 20.04
3.1.29-bionic, 3.1-bionic	Dockerfile	Ubuntu 18.04

.NET 7 Preview Tags

Tags	Dockerfile	OS Version
7.0.0-rc.2-bullseye-slim-amd64, 7.0-bullseye-slim-amd64, 7.0.0-rc.2-bullseye-slim, 7.0-bullseye-slim, 7.0.0-rc.2, 7.0, latest	Dockerfile	Debian 11
7.0.0-rc.2-alpine3.16-amd64, 7.0-alpine3.16-amd64, 7.0-alpine-amd64, 7.0.0-rc.2-alpine3.16, 7.0-alpine3.16, 7.0-alpine	Dockerfile	Alpine 3.16
7.0.0-rc.2-jammy-amd64, 7.0-jammy-amd64, 7.0.0-rc.2-jammy, 7.0-jammy	Dockerfile	Ubuntu 22.04
7.0.0-rc.2-jammy-chiseled-amd64, 7.0-jammy-chiseled-amd64, 7.0.0-rc.2-jammy-chiseled, 7.0-jammy-chiseled	Dockerfile	Ubuntu 22.04

Linux arm64 Tags

Tags	Dockerfile	OS Version
6.0.9-bullseye-slim-arm64v8, 6.0-bullseye-slim-arm64v8, 6.0.9-bullseye-slim, 6.0-bullseye-slim, 6.0.9, 6.0	Dockerfile	Debian 11
6.0.9-alpine3.16-arm64v8, 6.0-alpine3.16-arm64v8, 6.0-alpine-arm64v8, 6.0.9-alpine3.16, 6.0-alpine3.16, 6.0-alpine	Dockerfile	Alpine 3.16
6.0.9-jammy-arm64v8, 6.0-jammy-arm64v8, 6.0.9-jammy, 6.0-jammy	Dockerfile	Ubuntu 22.04
6.0.9-jammy-chiseled-arm64v8, 6.0-jammy-chiseled-arm64v8, 6.0.9-jammy-chiseled, 6.0-jammy-chiseled	Dockerfile	Ubuntu 22.04
6.0.9-focal-arm64v8, 6.0-focal-arm64v8, 6.0.9-focal, 6.0-focal	Dockerfile	Ubuntu 20.04
3.1.29-bullseye-slim-arm64v8, 3.1-bullseye-slim-arm64v8	Dockerfile	Debian 11
3.1.29-buster-slim-arm64v8, 3.1-buster-slim-arm64v8, 3.1.29, 3.1	Dockerfile	Debian 10
3.1.29-alpine3.16-arm64v8, 3.1-alpine3.16-arm64v8, 3.1-alpine-arm64v8	Dockerfile	Alpine 3.16
3.1.29-focal-arm64v8, 3.1-focal-arm64v8	Dockerfile	Ubuntu 20.04
3.1.29-bionic-arm64v8, 3.1-bionic-arm64v8	Dockerfile	Ubuntu 18.04

.NET 7 Preview Tags

Tags	Dockerfile	OS Version
7.0.0-rc.2-bullseye-slim-arm64v8, 7.0-bullseye-slim-arm64v8, 7.0.0-rc.2-bullseye-slim, 7.0-bullseye-slim, 7.0.0-rc.2, 7.0, latest	Dockerfile	Debian 11
7.0.0-rc.2-alpine3.16-arm64v8, 7.0-alpine3.16-arm64v8, 7.0-alpine-arm64v8, 7.0.0-rc.2-alpine3.16, 7.0-alpine3.16, 7.0-alpine	Dockerfile	Alpine 3.16
7.0.0-rc.2-jammy-arm64v8, 7.0-jammy-arm64v8, 7.0.0-rc.2-jammy, 7.0-jammy	Dockerfile	Ubuntu 22.04
7.0.0-rc.2-jammy-chiseled-arm64v8, 7.0-jammy-chiseled-arm64v8, 7.0.0-rc.2-jammy-chiseled, 7.0-jammy-chiseled	Dockerfile	Ubuntu 22.04

Linux arm32 Tags

Tags	Dockerfile	OS Version
6.0.9-bullseye-slim-arm32v7, 6.0-bullseye-slim-arm32v7, 6.0.9-bullseye-slim, 6.0-bullseye-slim, 6.0.9, 6.0	Dockerfile	Debian 11
6.0.9-alpine3.16-arm32v7, 6.0-alpine3.16-arm32v7, 6.0-alpine-arm32v7, 6.0.9-alpine3.16, 6.0-alpine3.16, 6.0-alpine	Dockerfile	Alpine 3.16
6.0.9-jammy-arm32v7, 6.0-jammy-arm32v7, 6.0.9-jammy, 6.0-jammy	Dockerfile	Ubuntu 22.04
6.0.9-focal-arm32v7, 6.0-focal-arm32v7, 6.0.9-focal, 6.0-focal	Dockerfile	Ubuntu 20.04
3.1.29-bullseye-slim-arm32v7, 3.1-bullseye-slim-arm32v7	Dockerfile	Debian 11
3.1.29-buster-slim-arm32v7, 3.1-buster-slim-arm32v7, 3.1.29, 3.1	Dockerfile	Debian 10
3.1.29-focal-arm32v7, 3.1-focal-arm32v7	Dockerfile	Ubuntu 20.04
3.1.29-bionic-arm32v7, 3.1-bionic-arm32v7	Dockerfile	Ubuntu 18.04

.NET 7 Preview Tags

Tags	Dockerfile	OS Version
7.0.0-rc.2-bullseye-slim-arm32v7, 7.0-bullseye-slim-arm32v7, 7.0.0-rc.2-bullseye-slim, 7.0-bullseye-slim, 7.0.0-rc.2, 7.0, latest	Dockerfile	Debian 11
7.0.0-rc.2-alpine3.16-arm32v7, 7.0-alpine3.16-arm32v7, 7.0-alpine-arm32v7, 7.0.0-rc.2-alpine3.16, 7.0-alpine3.16, 7.0-alpine	Dockerfile	Alpine 3.16
7.0.0-rc.2-jammy-arm32v7, 7.0-jammy-arm32v7, 7.0.0-rc.2-jammy, 7.0-jammy	Dockerfile	Ubuntu 22.04

Nano Server 2022 amd64 Tags

Tag	Dockerfile
6.0.9-nanoserver-ltsc2022, 6.0-nanoserver-ltsc2022, 6.0.9, 6.0	Dockerfile
3.1.29-nanoserver-ltsc2022, 3.1-nanoserver-ltsc2022, 3.1.29, 3.1	Dockerfile

.NET 7 Preview Tags

Tag	Dockerfile
7.0.0-rc.2-nanoserver-ltsc2022, 7.0-nanoserver-ltsc2022, 7.0.0-rc.2, 7.0, latest	Dockerfile

Windows Server Core 2022 amd64 Tags

Tag	Dockerfile
6.0.9-windowsservercore-ltsc2022, 6.0-windowsservercore-ltsc2022	Dockerfile

.NET 7 Preview Tags

Tag	Dockerfile
7.0.0-rc.2-windowsservercore-ltsc2022, 7.0-windowsservercore-ltsc2022	Dockerfile

Nano Server, version 1809 amd64 Tags

Tag	Dockerfile
6.0.9-nanoserver-1809, 6.0-nanoserver-1809, 6.0.9, 6.0	Dockerfile
3.1.29-nanoserver-1809, 3.1-nanoserver-1809, 3.1.29, 3.1	Dockerfile

.NET 7 Preview Tags

Tag	Dockerfile
7.0.0-rc.2-nanoserver-1809, 7.0-nanoserver-1809, 7.0.0-rc.2, 7.0, latest	Dockerfile

Windows Server Core 2019 amd64 Tags

Tag	Dockerfile
6.0.9-windowsservercore-ltsc2019, 6.0-windowsservercore-ltsc2019	Dockerfile

.NET 7 Preview Tags

Tag	Dockerfile
7.0.0-rc.2-windowsservercore-ltsc2019, 7.0-windowsservercore-ltsc2019	Dockerfile

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

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