README.sdk.md

Featured Tags

• 3.0 (Current)
  • docker pull mcr.microsoft.com/dotnet/core/sdk:3.0
• 2.1 (LTS)
  • docker pull mcr.microsoft.com/dotnet/core/sdk:2.1

About This Image

This image contains the .NET Core SDK which is comprised of three parts:

1. .NET Core CLI
2. .NET Core
3. ASP.NET Core

Use this image for your development process (developing, building and testing applications).

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.

Building .NET Core Apps with Docker

• .NET Core Docker Sample - This sample builds, tests, and runs the sample. It includes and builds multiple projects.
• ASP.NET Core Docker Sample - This sample demonstrates using Docker with an ASP.NET Core Web App.

Develop .NET Core Apps in a Container

• Develop .NET Core Applications - This sample shows how to develop, build and test .NET Core applications with Docker without the need to install the .NET Core SDK.
• Develop ASP.NET Core Applications - This sample shows how to develop and test ASP.NET Core applications with Docker without the need to install the .NET Core SDK.

Related Repos

.NET Core:

• dotnet/core: .NET Core
• dotnet/core/aspnet: ASP.NET Core Runtime
• dotnet/core/runtime: .NET Core Runtime
• dotnet/core/runtime-deps: .NET Core Runtime Dependencies
• dotnet/core/samples: .NET Core Samples
• 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
3.0.100-buster, 3.0-buster, 3.0.100, 3.0, latest	Dockerfile	Debian 10
3.0.100-alpine3.9, 3.0-alpine3.9, 3.0.100-alpine, 3.0-alpine	Dockerfile	Alpine 3.9
3.0.100-disco, 3.0-disco	Dockerfile	Ubuntu 19.04
3.0.100-bionic, 3.0-bionic	Dockerfile	Ubuntu 18.04
2.2.402-stretch, 2.2-stretch, 2.2.402, 2.2	Dockerfile	Debian 9
2.2.402-alpine3.9, 2.2-alpine3.9, 2.2.402-alpine, 2.2-alpine	Dockerfile	Alpine 3.9
2.2.402-bionic, 2.2-bionic	Dockerfile	Ubuntu 18.04
2.1.802-stretch, 2.1-stretch, 2.1.802, 2.1	Dockerfile	Debian 9
2.1.802-alpine3.9, 2.1-alpine3.9, 2.1.802-alpine, 2.1-alpine	Dockerfile	Alpine 3.9
2.1.802-bionic, 2.1-bionic	Dockerfile	Ubuntu 18.04

.NET Core 3.1 Preview Tags

Tags	Dockerfile	OS Version
3.1.100-preview1-buster, 3.1-buster, 3.1.100-preview1, 3.1	Dockerfile	Debian 10
3.1.100-preview1-alpine3.10, 3.1-alpine3.10, 3.1.100-preview1-alpine, 3.1-alpine	Dockerfile	Alpine 3.10
3.1.100-preview1-bionic, 3.1-bionic	Dockerfile	Ubuntu 18.04

Linux arm64 Tags

Tags	Dockerfile	OS Version
3.0.100-buster-arm64v8, 3.0-buster-arm64v8, 3.0.100, 3.0, latest	Dockerfile	Debian 10
3.0.100-disco-arm64v8, 3.0-disco-arm64v8	Dockerfile	Ubuntu 19.04
3.0.100-bionic-arm64v8, 3.0-bionic-arm64v8	Dockerfile	Ubuntu 18.04

.NET Core 3.1 Preview Tags

Tags	Dockerfile	OS Version
3.1.100-preview1-buster-arm64v8, 3.1-buster-arm64v8, 3.1.100-preview1, 3.1	Dockerfile	Debian 10
3.1.100-preview1-bionic-arm64v8, 3.1-bionic-arm64v8	Dockerfile	Ubuntu 18.04

Linux arm32 Tags

Tags	Dockerfile	OS Version
3.0.100-buster-arm32v7, 3.0-buster-arm32v7, 3.0.100, 3.0, latest	Dockerfile	Debian 10
3.0.100-disco-arm32v7, 3.0-disco-arm32v7	Dockerfile	Ubuntu 19.04
3.0.100-bionic-arm32v7, 3.0-bionic-arm32v7	Dockerfile	Ubuntu 18.04
2.2.402-stretch-arm32v7, 2.2-stretch-arm32v7, 2.2.402, 2.2	Dockerfile	Debian 9
2.2.402-bionic-arm32v7, 2.2-bionic-arm32v7	Dockerfile	Ubuntu 18.04
2.1.802-stretch-arm32v7, 2.1-stretch-arm32v7, 2.1.802, 2.1	Dockerfile	Debian 9
2.1.802-bionic-arm32v7, 2.1-bionic-arm32v7	Dockerfile	Ubuntu 18.04

.NET Core 3.1 Preview Tags

Tags	Dockerfile	OS Version
3.1.100-preview1-buster-arm32v7, 3.1-buster-arm32v7, 3.1.100-preview1, 3.1	Dockerfile	Debian 10
3.1.100-preview1-bionic-arm32v7, 3.1-bionic-arm32v7	Dockerfile	Ubuntu 18.04

Windows Server, version 1903 amd64 Tags

Tag	Dockerfile
3.0.100-nanoserver-1903, 3.0-nanoserver-1903, 3.0.100, 3.0, latest	Dockerfile
2.2.402-nanoserver-1903, 2.2-nanoserver-1903, 2.2.402, 2.2	Dockerfile
2.1.802-nanoserver-1903, 2.1-nanoserver-1903, 2.1.802, 2.1	Dockerfile

.NET Core 3.1 Preview Tags

Tag	Dockerfile
3.1.100-preview1-nanoserver-1903, 3.1-nanoserver-1903, 3.1.100-preview1, 3.1	Dockerfile

Windows Server 2019 amd64 Tags

Tag	Dockerfile
3.0.100-nanoserver-1809, 3.0-nanoserver-1809, 3.0.100, 3.0, latest	Dockerfile
2.2.402-nanoserver-1809, 2.2-nanoserver-1809, 2.2.402, 2.2	Dockerfile
2.1.802-nanoserver-1809, 2.1-nanoserver-1809, 2.1.802, 2.1	Dockerfile

.NET Core 3.1 Preview Tags

Tag	Dockerfile
3.1.100-preview1-nanoserver-1809, 3.1-nanoserver-1809, 3.1.100-preview1, 3.1	Dockerfile

Windows Server 2019 arm32 Tags

Tag	Dockerfile
3.0.100-nanoserver-1809-arm32v7, 3.0-nanoserver-1809-arm32v7, 3.0.100, 3.0, latest	Dockerfile
2.2.402-nanoserver-1809-arm32v7, 2.2-nanoserver-1809-arm32v7, 2.2.402, 2.2	Dockerfile

.NET Core 3.1 Preview Tags

Tag	Dockerfile
3.1.100-preview1-nanoserver-1809-arm32v7, 3.1-nanoserver-1809-arm32v7, 3.1.100-preview1, 3.1	Dockerfile

Windows Server, version 1803 amd64 Tags

Tag	Dockerfile
3.0.100-nanoserver-1803, 3.0-nanoserver-1803, 3.0.100, 3.0, latest	Dockerfile
2.2.402-nanoserver-1803, 2.2-nanoserver-1803, 2.2.402, 2.2	Dockerfile
2.1.802-nanoserver-1803, 2.1-nanoserver-1803, 2.1.802, 2.1	Dockerfile

.NET Core 3.1 Preview Tags

Tag	Dockerfile
3.1.100-preview1-nanoserver-1803, 3.1-nanoserver-1803, 3.1.100-preview1, 3.1	Dockerfile

You can retrieve a list of all available tags for dotnet/core/sdk at https://mcr.microsoft.com/v2/dotnet/core/sdk/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