Skip to content

Latest commit

 

History

History
189 lines (145 loc) · 16.3 KB

README.aspnet.md

File metadata and controls

189 lines (145 loc) · 16.3 KB
Raw

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.4-bullseye-slim-amd64, 7.0-bullseye-slim-amd64, 7.0.4-bullseye-slim, 7.0-bullseye-slim, 7.0.4, 7.0, latest Dockerfile Debian 11
7.0.4-alpine3.17-amd64, 7.0-alpine3.17-amd64, 7.0-alpine-amd64, 7.0.4-alpine3.17, 7.0-alpine3.17, 7.0-alpine Dockerfile Alpine 3.17
7.0.4-alpine3.16-amd64, 7.0-alpine3.16-amd64, 7.0.4-alpine3.16, 7.0-alpine3.16 Dockerfile Alpine 3.16
7.0.4-jammy-amd64, 7.0-jammy-amd64, 7.0.4-jammy, 7.0-jammy Dockerfile Ubuntu 22.04
6.0.15-bullseye-slim-amd64, 6.0-bullseye-slim-amd64, 6.0.15-bullseye-slim, 6.0-bullseye-slim, 6.0.15, 6.0 Dockerfile Debian 11
6.0.15-alpine3.17-amd64, 6.0-alpine3.17-amd64, 6.0-alpine-amd64, 6.0.15-alpine3.17, 6.0-alpine3.17, 6.0-alpine Dockerfile Alpine 3.17
6.0.15-alpine3.16-amd64, 6.0-alpine3.16-amd64, 6.0.15-alpine3.16, 6.0-alpine3.16 Dockerfile Alpine 3.16
6.0.15-jammy-amd64, 6.0-jammy-amd64, 6.0.15-jammy, 6.0-jammy Dockerfile Ubuntu 22.04
6.0.15-focal-amd64, 6.0-focal-amd64, 6.0.15-focal, 6.0-focal Dockerfile Ubuntu 20.04
.NET 8 Preview Tags
Tags Dockerfile OS Version
8.0.0-preview.2-bookworm-slim-amd64, 8.0-preview-bookworm-slim-amd64, 8.0.0-preview.2-bookworm-slim, 8.0-preview-bookworm-slim, 8.0.0-preview.2, 8.0-preview Dockerfile Debian 12
8.0.0-preview.2-alpine3.17-amd64, 8.0-preview-alpine3.17-amd64, 8.0-preview-alpine-amd64, 8.0.0-preview.2-alpine3.17, 8.0-preview-alpine3.17, 8.0-preview-alpine Dockerfile Alpine 3.17
8.0.0-preview.2-jammy-amd64, 8.0-preview-jammy-amd64, 8.0.0-preview.2-jammy, 8.0-preview-jammy Dockerfile Ubuntu 22.04
8.0.0-preview.2-jammy-chiseled-amd64, 8.0-preview-jammy-chiseled-amd64, 8.0.0-preview.2-jammy-chiseled, 8.0-preview-jammy-chiseled Dockerfile Ubuntu 22.04

Linux arm64 Tags

Tags Dockerfile OS Version
7.0.4-bullseye-slim-arm64v8, 7.0-bullseye-slim-arm64v8, 7.0.4-bullseye-slim, 7.0-bullseye-slim, 7.0.4, 7.0, latest Dockerfile Debian 11
7.0.4-alpine3.17-arm64v8, 7.0-alpine3.17-arm64v8, 7.0-alpine-arm64v8, 7.0.4-alpine3.17, 7.0-alpine3.17, 7.0-alpine Dockerfile Alpine 3.17
7.0.4-alpine3.16-arm64v8, 7.0-alpine3.16-arm64v8, 7.0.4-alpine3.16, 7.0-alpine3.16 Dockerfile Alpine 3.16
7.0.4-jammy-arm64v8, 7.0-jammy-arm64v8, 7.0.4-jammy, 7.0-jammy Dockerfile Ubuntu 22.04
6.0.15-bullseye-slim-arm64v8, 6.0-bullseye-slim-arm64v8, 6.0.15-bullseye-slim, 6.0-bullseye-slim, 6.0.15, 6.0 Dockerfile Debian 11
6.0.15-alpine3.17-arm64v8, 6.0-alpine3.17-arm64v8, 6.0-alpine-arm64v8, 6.0.15-alpine3.17, 6.0-alpine3.17, 6.0-alpine Dockerfile Alpine 3.17
6.0.15-alpine3.16-arm64v8, 6.0-alpine3.16-arm64v8, 6.0.15-alpine3.16, 6.0-alpine3.16 Dockerfile Alpine 3.16
6.0.15-jammy-arm64v8, 6.0-jammy-arm64v8, 6.0.15-jammy, 6.0-jammy Dockerfile Ubuntu 22.04
6.0.15-focal-arm64v8, 6.0-focal-arm64v8, 6.0.15-focal, 6.0-focal Dockerfile Ubuntu 20.04
.NET 8 Preview Tags
Tags Dockerfile OS Version
8.0.0-preview.2-bookworm-slim-arm64v8, 8.0-preview-bookworm-slim-arm64v8, 8.0.0-preview.2-bookworm-slim, 8.0-preview-bookworm-slim, 8.0.0-preview.2, 8.0-preview Dockerfile Debian 12
8.0.0-preview.2-alpine3.17-arm64v8, 8.0-preview-alpine3.17-arm64v8, 8.0-preview-alpine-arm64v8, 8.0.0-preview.2-alpine3.17, 8.0-preview-alpine3.17, 8.0-preview-alpine Dockerfile Alpine 3.17
8.0.0-preview.2-jammy-arm64v8, 8.0-preview-jammy-arm64v8, 8.0.0-preview.2-jammy, 8.0-preview-jammy Dockerfile Ubuntu 22.04
8.0.0-preview.2-jammy-chiseled-arm64v8, 8.0-preview-jammy-chiseled-arm64v8, 8.0.0-preview.2-jammy-chiseled, 8.0-preview-jammy-chiseled Dockerfile Ubuntu 22.04

Linux arm32 Tags

Tags Dockerfile OS Version
7.0.4-bullseye-slim-arm32v7, 7.0-bullseye-slim-arm32v7, 7.0.4-bullseye-slim, 7.0-bullseye-slim, 7.0.4, 7.0, latest Dockerfile Debian 11
7.0.4-alpine3.17-arm32v7, 7.0-alpine3.17-arm32v7, 7.0-alpine-arm32v7, 7.0.4-alpine3.17, 7.0-alpine3.17, 7.0-alpine Dockerfile Alpine 3.17
7.0.4-alpine3.16-arm32v7, 7.0-alpine3.16-arm32v7, 7.0.4-alpine3.16, 7.0-alpine3.16 Dockerfile Alpine 3.16
7.0.4-jammy-arm32v7, 7.0-jammy-arm32v7, 7.0.4-jammy, 7.0-jammy Dockerfile Ubuntu 22.04
6.0.15-bullseye-slim-arm32v7, 6.0-bullseye-slim-arm32v7, 6.0.15-bullseye-slim, 6.0-bullseye-slim, 6.0.15, 6.0 Dockerfile Debian 11
6.0.15-alpine3.17-arm32v7, 6.0-alpine3.17-arm32v7, 6.0-alpine-arm32v7, 6.0.15-alpine3.17, 6.0-alpine3.17, 6.0-alpine Dockerfile Alpine 3.17
6.0.15-alpine3.16-arm32v7, 6.0-alpine3.16-arm32v7, 6.0.15-alpine3.16, 6.0-alpine3.16 Dockerfile Alpine 3.16
6.0.15-jammy-arm32v7, 6.0-jammy-arm32v7, 6.0.15-jammy, 6.0-jammy Dockerfile Ubuntu 22.04
6.0.15-focal-arm32v7, 6.0-focal-arm32v7, 6.0.15-focal, 6.0-focal Dockerfile Ubuntu 20.04
.NET 8 Preview Tags
Tags Dockerfile OS Version
8.0.0-preview.2-bookworm-slim-arm32v7, 8.0-preview-bookworm-slim-arm32v7, 8.0.0-preview.2-bookworm-slim, 8.0-preview-bookworm-slim, 8.0.0-preview.2, 8.0-preview Dockerfile Debian 12
8.0.0-preview.2-alpine3.17-arm32v7, 8.0-preview-alpine3.17-arm32v7, 8.0-preview-alpine-arm32v7, 8.0.0-preview.2-alpine3.17, 8.0-preview-alpine3.17, 8.0-preview-alpine Dockerfile Alpine 3.17
8.0.0-preview.2-jammy-arm32v7, 8.0-preview-jammy-arm32v7, 8.0.0-preview.2-jammy, 8.0-preview-jammy Dockerfile Ubuntu 22.04
8.0.0-preview.2-jammy-chiseled-arm32v7, 8.0-preview-jammy-chiseled-arm32v7, 8.0.0-preview.2-jammy-chiseled, 8.0-preview-jammy-chiseled Dockerfile Ubuntu 22.04

Nano Server 2022 amd64 Tags

Tag Dockerfile
7.0.4-nanoserver-ltsc2022, 7.0-nanoserver-ltsc2022, 7.0.4, 7.0, latest Dockerfile
6.0.15-nanoserver-ltsc2022, 6.0-nanoserver-ltsc2022, 6.0.15, 6.0 Dockerfile
.NET 8 Preview Tags
Tag Dockerfile
8.0.0-preview.2-nanoserver-ltsc2022, 8.0-preview-nanoserver-ltsc2022, 8.0.0-preview.2, 8.0-preview Dockerfile

Windows Server Core 2022 amd64 Tags

Tag Dockerfile
7.0.4-windowsservercore-ltsc2022, 7.0-windowsservercore-ltsc2022 Dockerfile
6.0.15-windowsservercore-ltsc2022, 6.0-windowsservercore-ltsc2022 Dockerfile
.NET 8 Preview Tags
Tag Dockerfile
8.0.0-preview.2-windowsservercore-ltsc2022, 8.0-preview-windowsservercore-ltsc2022 Dockerfile

Nano Server, version 1809 amd64 Tags

Tag Dockerfile
7.0.4-nanoserver-1809, 7.0-nanoserver-1809, 7.0.4, 7.0, latest Dockerfile
6.0.15-nanoserver-1809, 6.0-nanoserver-1809, 6.0.15, 6.0 Dockerfile
.NET 8 Preview Tags
Tag Dockerfile
8.0.0-preview.2-nanoserver-1809, 8.0-preview-nanoserver-1809, 8.0.0-preview.2, 8.0-preview Dockerfile

Windows Server Core 2019 amd64 Tags

Tag Dockerfile
7.0.4-windowsservercore-ltsc2019, 7.0-windowsservercore-ltsc2019 Dockerfile
6.0.15-windowsservercore-ltsc2019, 6.0-windowsservercore-ltsc2019 Dockerfile
.NET 8 Preview Tags
Tag Dockerfile
8.0.0-preview.2-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