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

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

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

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'

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

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