.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

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!