Featured Tags
7.0 (Standard Support)
docker pull mcr.microsoft.com/dotnet/aspnet:7.0
6.0 (Long-Term Support)
docker pull mcr.microsoft.com/dotnet/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 Repositories
.NET:
.NET Framework:
Full Tag Listing
Linux amd64 Tags
| Tags |
Dockerfile |
OS Version |
| 7.0.5-bullseye-slim-amd64, 7.0-bullseye-slim-amd64, 7.0.5-bullseye-slim, 7.0-bullseye-slim, 7.0.5, 7.0, latest |
Dockerfile |
Debian 11 |
| 7.0.5-alpine3.17-amd64, 7.0-alpine3.17-amd64, 7.0-alpine-amd64, 7.0.5-alpine3.17, 7.0-alpine3.17, 7.0-alpine |
Dockerfile |
Alpine 3.17 |
| 7.0.5-jammy-amd64, 7.0-jammy-amd64, 7.0.5-jammy, 7.0-jammy |
Dockerfile |
Ubuntu 22.04 |
| 6.0.16-bullseye-slim-amd64, 6.0-bullseye-slim-amd64, 6.0.16-bullseye-slim, 6.0-bullseye-slim, 6.0.16, 6.0 |
Dockerfile |
Debian 11 |
| 6.0.16-alpine3.17-amd64, 6.0-alpine3.17-amd64, 6.0-alpine-amd64, 6.0.16-alpine3.17, 6.0-alpine3.17, 6.0-alpine |
Dockerfile |
Alpine 3.17 |
| 6.0.16-jammy-amd64, 6.0-jammy-amd64, 6.0.16-jammy, 6.0-jammy |
Dockerfile |
Ubuntu 22.04 |
| 6.0.16-focal-amd64, 6.0-focal-amd64, 6.0.16-focal, 6.0-focal |
Dockerfile |
Ubuntu 20.04 |
.NET 8 Preview Tags
| Tags |
Dockerfile |
OS Version |
| 8.0.0-preview.3-bookworm-slim-amd64, 8.0-preview-bookworm-slim-amd64, 8.0.0-preview.3-bookworm-slim, 8.0-preview-bookworm-slim, 8.0.0-preview.3, 8.0-preview |
Dockerfile |
Debian 12 |
| 8.0.0-preview.3-alpine3.17-amd64, 8.0-preview-alpine3.17-amd64, 8.0-preview-alpine-amd64, 8.0.0-preview.3-alpine3.17, 8.0-preview-alpine3.17, 8.0-preview-alpine |
Dockerfile |
Alpine 3.17 |
| 8.0.0-preview.3-jammy-amd64, 8.0-preview-jammy-amd64, 8.0.0-preview.3-jammy, 8.0-preview-jammy |
Dockerfile |
Ubuntu 22.04 |
| 8.0.0-preview.3-jammy-chiseled-amd64, 8.0-preview-jammy-chiseled-amd64, 8.0.0-preview.3-jammy-chiseled, 8.0-preview-jammy-chiseled |
Dockerfile |
Ubuntu 22.04 |
Linux arm64 Tags
| Tags |
Dockerfile |
OS Version |
| 7.0.5-bullseye-slim-arm64v8, 7.0-bullseye-slim-arm64v8, 7.0.5-bullseye-slim, 7.0-bullseye-slim, 7.0.5, 7.0, latest |
Dockerfile |
Debian 11 |
| 7.0.5-alpine3.17-arm64v8, 7.0-alpine3.17-arm64v8, 7.0-alpine-arm64v8, 7.0.5-alpine3.17, 7.0-alpine3.17, 7.0-alpine |
Dockerfile |
Alpine 3.17 |
| 7.0.5-jammy-arm64v8, 7.0-jammy-arm64v8, 7.0.5-jammy, 7.0-jammy |
Dockerfile |
Ubuntu 22.04 |
| 6.0.16-bullseye-slim-arm64v8, 6.0-bullseye-slim-arm64v8, 6.0.16-bullseye-slim, 6.0-bullseye-slim, 6.0.16, 6.0 |
Dockerfile |
Debian 11 |
| 6.0.16-alpine3.17-arm64v8, 6.0-alpine3.17-arm64v8, 6.0-alpine-arm64v8, 6.0.16-alpine3.17, 6.0-alpine3.17, 6.0-alpine |
Dockerfile |
Alpine 3.17 |
| 6.0.16-jammy-arm64v8, 6.0-jammy-arm64v8, 6.0.16-jammy, 6.0-jammy |
Dockerfile |
Ubuntu 22.04 |
| 6.0.16-focal-arm64v8, 6.0-focal-arm64v8, 6.0.16-focal, 6.0-focal |
Dockerfile |
Ubuntu 20.04 |
.NET 8 Preview Tags
| Tags |
Dockerfile |
OS Version |
| 8.0.0-preview.3-bookworm-slim-arm64v8, 8.0-preview-bookworm-slim-arm64v8, 8.0.0-preview.3-bookworm-slim, 8.0-preview-bookworm-slim, 8.0.0-preview.3, 8.0-preview |
Dockerfile |
Debian 12 |
| 8.0.0-preview.3-alpine3.17-arm64v8, 8.0-preview-alpine3.17-arm64v8, 8.0-preview-alpine-arm64v8, 8.0.0-preview.3-alpine3.17, 8.0-preview-alpine3.17, 8.0-preview-alpine |
Dockerfile |
Alpine 3.17 |
| 8.0.0-preview.3-jammy-arm64v8, 8.0-preview-jammy-arm64v8, 8.0.0-preview.3-jammy, 8.0-preview-jammy |
Dockerfile |
Ubuntu 22.04 |
| 8.0.0-preview.3-jammy-chiseled-arm64v8, 8.0-preview-jammy-chiseled-arm64v8, 8.0.0-preview.3-jammy-chiseled, 8.0-preview-jammy-chiseled |
Dockerfile |
Ubuntu 22.04 |
Linux arm32 Tags
| Tags |
Dockerfile |
OS Version |
| 7.0.5-bullseye-slim-arm32v7, 7.0-bullseye-slim-arm32v7, 7.0.5-bullseye-slim, 7.0-bullseye-slim, 7.0.5, 7.0, latest |
Dockerfile |
Debian 11 |
| 7.0.5-alpine3.17-arm32v7, 7.0-alpine3.17-arm32v7, 7.0-alpine-arm32v7, 7.0.5-alpine3.17, 7.0-alpine3.17, 7.0-alpine |
Dockerfile |
Alpine 3.17 |
| 7.0.5-jammy-arm32v7, 7.0-jammy-arm32v7, 7.0.5-jammy, 7.0-jammy |
Dockerfile |
Ubuntu 22.04 |
| 6.0.16-bullseye-slim-arm32v7, 6.0-bullseye-slim-arm32v7, 6.0.16-bullseye-slim, 6.0-bullseye-slim, 6.0.16, 6.0 |
Dockerfile |
Debian 11 |
| 6.0.16-alpine3.17-arm32v7, 6.0-alpine3.17-arm32v7, 6.0-alpine-arm32v7, 6.0.16-alpine3.17, 6.0-alpine3.17, 6.0-alpine |
Dockerfile |
Alpine 3.17 |
| 6.0.16-jammy-arm32v7, 6.0-jammy-arm32v7, 6.0.16-jammy, 6.0-jammy |
Dockerfile |
Ubuntu 22.04 |
| 6.0.16-focal-arm32v7, 6.0-focal-arm32v7, 6.0.16-focal, 6.0-focal |
Dockerfile |
Ubuntu 20.04 |
.NET 8 Preview Tags
| Tags |
Dockerfile |
OS Version |
| 8.0.0-preview.3-bookworm-slim-arm32v7, 8.0-preview-bookworm-slim-arm32v7, 8.0.0-preview.3-bookworm-slim, 8.0-preview-bookworm-slim, 8.0.0-preview.3, 8.0-preview |
Dockerfile |
Debian 12 |
| 8.0.0-preview.3-alpine3.17-arm32v7, 8.0-preview-alpine3.17-arm32v7, 8.0-preview-alpine-arm32v7, 8.0.0-preview.3-alpine3.17, 8.0-preview-alpine3.17, 8.0-preview-alpine |
Dockerfile |
Alpine 3.17 |
| 8.0.0-preview.3-jammy-arm32v7, 8.0-preview-jammy-arm32v7, 8.0.0-preview.3-jammy, 8.0-preview-jammy |
Dockerfile |
Ubuntu 22.04 |
| 8.0.0-preview.3-jammy-chiseled-arm32v7, 8.0-preview-jammy-chiseled-arm32v7, 8.0.0-preview.3-jammy-chiseled, 8.0-preview-jammy-chiseled |
Dockerfile |
Ubuntu 22.04 |
Nano Server 2022 amd64 Tags
| Tag |
Dockerfile |
| 7.0.5-nanoserver-ltsc2022, 7.0-nanoserver-ltsc2022, 7.0.5, 7.0, latest |
Dockerfile |
| 6.0.16-nanoserver-ltsc2022, 6.0-nanoserver-ltsc2022, 6.0.16, 6.0 |
Dockerfile |
.NET 8 Preview Tags
| Tag |
Dockerfile |
| 8.0.0-preview.3-nanoserver-ltsc2022, 8.0-preview-nanoserver-ltsc2022 |
Dockerfile |
Windows Server Core 2022 amd64 Tags
| Tag |
Dockerfile |
| 7.0.5-windowsservercore-ltsc2022, 7.0-windowsservercore-ltsc2022 |
Dockerfile |
| 6.0.16-windowsservercore-ltsc2022, 6.0-windowsservercore-ltsc2022 |
Dockerfile |
.NET 8 Preview Tags
| Tag |
Dockerfile |
| 8.0.0-preview.3-windowsservercore-ltsc2022, 8.0-preview-windowsservercore-ltsc2022 |
Dockerfile |
Nano Server, version 1809 amd64 Tags
| Tag |
Dockerfile |
| 7.0.5-nanoserver-1809, 7.0-nanoserver-1809, 7.0.5, 7.0, latest |
Dockerfile |
| 6.0.16-nanoserver-1809, 6.0-nanoserver-1809, 6.0.16, 6.0 |
Dockerfile |
.NET 8 Preview Tags
| Tag |
Dockerfile |
| 8.0.0-preview.3-nanoserver-1809, 8.0-preview-nanoserver-1809 |
Dockerfile |
Windows Server Core 2019 amd64 Tags
| Tag |
Dockerfile |
| 7.0.5-windowsservercore-ltsc2019, 7.0-windowsservercore-ltsc2019 |
Dockerfile |
| 6.0.16-windowsservercore-ltsc2019, 6.0-windowsservercore-ltsc2019 |
Dockerfile |
.NET 8 Preview Tags
| Tag |
Dockerfile |
| 8.0.0-preview.3-windowsservercore-ltsc2019, 8.0-preview-windowsservercore-ltsc2019 |
Dockerfile |
You can retrieve a list of all available tags for dotnet/aspnet at https://mcr.microsoft.com/v2/dotnet/aspnet/tags/list.
For tags contained in the old dotnet/core/aspnet repository, you can retrieve a list of those tags at https://mcr.microsoft.com/v2/dotnet/core/aspnet/tags/list.
Tags not listed in the table above are not supported. See the Supported Tags Policy
Support
Lifecycle
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
License
