dotnet-docker README

The project's README from github.com/dotnet/dotnet-docker. As one markdown file: README.md.

.NET

About

.NET is a general purpose development platform maintained by Microsoft and the .NET community on GitHub. It is cross-platform, supports Windows, macOS, and Linux, and can be used in device, cloud, and embedded/IoT scenarios.

.NET has several capabilities that make development productive, including automatic memory management, (runtime) generic types, reflection, asynchronous constructs, concurrency, and native interop. Millions of developers take advantage of these capabilities to efficiently build high-quality applications.

You can use C# or F# to write .NET apps.

.NET is open source (MIT and Apache 2 licenses) and was contributed to the .NET Foundation by Microsoft in 2014. It can be freely adopted by individuals and companies, including for personal, academic or commercial purposes. Multiple companies use .NET as part of apps, tools, new platforms and hosting services.

You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.

.NET Documentation

Watch discussions for Docker-related .NET announcements.

Usage

The .NET Docker samples show various ways to use .NET and Docker together. See Introduction to .NET and Docker to learn more.

Container sample: Run a simple application

You can quickly run a container with a pre-built .NET Docker image, based on the .NET console sample.

Type the following command to run a sample console application:

docker run --rm mcr.microsoft.com/dotnet/samples

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:8080 --name aspnetcore_sample mcr.microsoft.com/dotnet/samples:aspnetapp

After the application starts, navigate to http://localhost:8000 in your web browser. You can also view the ASP.NET Core site running in the container from another machine with a local IP address such as http://192.168.1.18:8000.

Note: ASP.NET Core apps (in official images) listen to port 8080 by default, starting with .NET 8. The -p argument in these examples maps host port 8000 to container port 8080 (host:container mapping). The container will not be accessible without this mapping. ASP.NET Core can be configured to listen on a different or additional port.

See Hosting ASP.NET Core Images with Docker over HTTPS to use HTTPS with this image.

Image Variants

.NET container images have several variants that offer different combinations of flexibility and deployment size. The Image Variants documentation contains a summary of the image variants and their use-cases.

Distroless images

.NET distroless container images contain only the minimal set of packages .NET needs, with everything else removed. Due to their limited set of packages, distroless containers have a minimized security attack surface, smaller deployment sizes, and faster start-up time compared to their non-distroless counterparts. They contain the following features:

.NET offers distroless images for Azure Linux and Ubuntu (Chiseled).

.NET:

.NET Framework:

Support

Lifecycle

Image Update Policy

CVE Update Policy

.NET container images are regularly monitored for the presence of CVEs. A given image will be rebuilt to pick up fixes for a CVE when:

Please refer to the Security Policy and Container Vulnerability Workflow for more detail about what to do when a CVE is encountered in a .NET image.

Feedback

License

dotnet-docker (dotnet/dotnet-docker)

Searching Database…

4.9K ·GitHub
Dotnet-docker
What is this?This is the official repository for .NET container images maintained by Microsoft, providing pre-built Docker images for running .NET apps.
Is this a set of Docker images or an actual SDK?It's a collection of Dockerfiles and documentation for official .NET container images (SDK, runtime, ASP.NET runtime, runtime-deps, monitor, aspire-dashboard) rather than the .NET SDK itself.
How do I run a .NET app in a container?Pull a pre-built .NET Docker image and run it directly, for example a console sample or an ASP.NET Core web sample image.
Do I need anything besides Docker to use these images?You just need Docker installed; the images bundle everything needed to run .NET apps, and you can write apps in C# or F#.
What port does the ASP.NET Core container listen on by default?Starting with .NET 8, ASP.NET Core apps in official images listen on port 8080 by default, so you must map host:container ports correctly or the app won't be reachable.
Which platforms are these container images for?.NET itself is cross-platform (Windows, macOS, Linux), and these Docker images specifically support Windows and Linux containers, including Azure Linux and Ubuntu Chiseled distroless variants.
What is a distroless .NET image?A minimized image containing only the packages .NET needs, with no shell, no package manager, and a non-root user by default, reducing attack surface and size.
How often are these images updated for security fixes?Base image updates trigger rebuilds within 12 hours, critical CVEs are patched as fixes become available, and images get a general monthly rebuild typically on the second Tuesday.
Are there preview versions of these images available?Yes, nightly/preview variants exist for the SDK, ASP.NET runtime, runtime, runtime-deps, monitor, and aspire-dashboard images.
Is there a legacy .NET Framework option too?Yes, dotnet/framework provides .NET Framework, ASP.NET, and WCF images alongside samples, separate from the cross-platform .NET images.
What are similar projects?dotnet-framework-docker, server, runtime, eShop, garnet, marzban-node, aspnetcore, kamal
Which topics is it in?dockerfile, runtime, devtools, microsoft, deployment, containers, dotnet, enterprise, csharp, cloud, devops, backend
Creator
dotnet
Size
37 MB
Stars
4.9K
Updated
CommitOct 14
Age
10y
Commits · 90 Days