.NET Docker Sample

This sample demonstrates how to build container images for .NET console apps. See .NET Docker Samples for more samples.

Run the sample image

You can start by launching a sample from our container registry.

docker run --rm mcr.microsoft.com/dotnet/samples:dotnetapp-chiseled

Build the image

You can build and run an image using the following instructions (cloninig the repo isn't necessary):

docker build --pull -t dotnetapp 'https://github.com/dotnet/dotnet-docker.git#:samples/dotnetapp'
docker run --rm dotnetapp

Add the argument -f <Dockerfile> to build the sample in a different configuration. For example, build an Ubuntu Chiseled image using Dockerfile.chiseled:

docker build --pull -t dotnetapp -f Dockerfile.chiseled 'https://github.com/dotnet/dotnet-docker.git#:samples/dotnetapp'

Supported Linux distros

The .NET Team publishes images for multiple distros.

Sample Dockerfiles are provided for:

• Alpine
• Alpine with ICU installed
• Azure Linux
• Azure Linux Distroless
• Ubuntu
• Ubuntu Chiseled

Supported Windows versions

The .NET Team publishes images for multiple Windows versions. You must have Windows containers enabled to use these images.

Samples are provided for

• Nano Server
• Windows Server Core

You can pull a pre-built Windows sample image using the following tag:

• mcr.microsoft.com/dotnet/samples:dotnetapp-nanoserver-ltsc2022