README.samples.md

Featured Tags

• dotnetapp (Dockerfile)
  • docker pull mcr.microsoft.com/dotnet/core/samples:dotnetapp
• aspnetapp (Dockerfile)
  • docker pull mcr.microsoft.com/dotnet/core/samples:aspnetapp

About This Image

These images contain sample .NET Core and ASP.NET Core applications.

Watch dotnet/announcements for Docker-related .NET announcements.

How to Use the Image

The .NET Core Docker samples show various ways to use .NET Core and Docker together. See Building Docker Images for .NET Core Applications to learn more.

Container sample: Run a simple application

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

Type the following command to run a sample console application:

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

Container sample: Run a web application

You can quickly run a container with a pre-built .NET Core 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/core/samples:aspnetapp

After the application starts, navigate to http://localhost:8000 in your web browser. On Windows, you may need to navigate to the container via IP address. See ASP.NET Core apps in Windows Containers for instructions on determining the IP address, using the value of --name that you used in docker run.

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

Related Repos

.NET Core:

• dotnet/core: .NET Core
• dotnet/core/sdk: .NET Core SDK
• dotnet/core/aspnet: ASP.NET Core Runtime
• dotnet/core/runtime: .NET Core Runtime
• dotnet/core/runtime-deps: .NET Core Runtime Dependencies
• dotnet/core-nightly: .NET Core (Preview)

.NET Framework:

• dotnet/framework: .NET Framework, ASP.NET and WCF
• dotnet/framework/samples: .NET Framework, ASP.NET and WCF Samples

Full Tag Listing

Linux amd64 Tags

Tags	Dockerfile	OS Version
dotnetapp-stretch, dotnetapp, latest	Dockerfile	Debian 9
aspnetapp-stretch, aspnetapp	Dockerfile	Debian 9

Linux arm32 Tags

Tags	Dockerfile	OS Version
dotnetapp-stretch-arm32v7, dotnetapp, latest	Dockerfile	Debian 9
aspnetapp-stretch-arm32v7, aspnetapp	Dockerfile	Debian 9

Windows Server, version 1903 amd64 Tags

Tag	Dockerfile
dotnetapp-nanoserver-1903, dotnetapp, latest	Dockerfile
aspnetapp-nanoserver-1903, aspnetapp	Dockerfile

Windows Server 2019 amd64 Tags

Tag	Dockerfile
dotnetapp-nanoserver-1809, dotnetapp, latest	Dockerfile
aspnetapp-nanoserver-1809, aspnetapp	Dockerfile

Windows Server 2019 arm32 Tags

Tag	Dockerfile
dotnetapp-nanoserver-1809-arm32v7, dotnetapp, latest	Dockerfile
aspnetapp-nanoserver-1809-arm32v7, aspnetapp	Dockerfile

Windows Server, version 1803 amd64 Tags

Tag	Dockerfile
dotnetapp-nanoserver-1803, dotnetapp, latest	Dockerfile
aspnetapp-nanoserver-1803, aspnetapp	Dockerfile

You can retrieve a list of all available tags for dotnet/core/samples at https://mcr.microsoft.com/v2/dotnet/core/samples/tags/list.

Support

See Microsoft Support for .NET Core for the support lifecycle.

Feedback

• File a .NET Core Docker issue
• File a .NET Core issue
• File an ASP.NET Core issue
• File an issue for other components
• Ask on Stack Overflow
• Contact Microsoft Support

License

• .NET Core license
• Windows Nano Server license (only applies to Windows containers)
• Pricing and licensing for Windows Server 2019