Container Base Images

Applies to: Windows Server 2022, Windows Server 2019, Windows Server 2016

Windows offers four container base images that users can build from. Each base image is a different type of the Windows or Windows Server operating system, has a different on-disk footprint, and has a different set of the Windows API set.

Image discovery

All Windows container base images are discoverable through Docker Hub. The Windows container base images themselves are served from mcr.microsoft.com, the Microsoft Container Registry (MCR). This is why the pull commands for the Windows container base images look like the following:

docker pull mcr.microsoft.com/windows/servercore:ltsc2022

The MCR does not have its own catalog experience and is meant to support existing catalogs, such as Docker Hub. Thanks to Azure's global footprint and coupled with Azure CDN, the MCR delivers an image pull experience that is consistent and fast. Azure customers, running their workloads in Azure, benefit from in-network performance enhancements as well as tight integration with the MCR (the source for Microsoft container images), Azure Marketplace, and the expanding number of services in Azure that offer containers as the deployment package format.

Choosing a base image

How do you choose the right base image to build upon? For most users, Windows Server Core and Nanoserver will be the most appropriate image to use. Each base image is briefly described below:

  • Nano Server is an ultralight Windows offering for new application development.
  • Server Core is medium in size and a good option for "lifting and shifting" Windows Server apps.
  • Windows is the largest image and has full Windows API support for workloads.
  • Windows Server is slightly smaller than the Windows image, has full Windows API support, and allows you to use more server features.

Guidelines

While you're free to target whichever image you want to use, here are some guidelines to help steer your choice:

  • Does your application require the full .NET framework? If the answer to this question is yes, you should target Windows Server Core.
  • Are you building a Windows app based upon .NET Core? If the answer to this question is yes, you should target Nanoserver.
  • Is the Windows Server Core container image missing a dependency your app needs? If the answer to this question is yes, you should attempt to target Windows. This image is much larger than the other base images, but it carries many of the core Windows libraries (such as the GDI library).
  • Are you a Windows Insider? If yes, you should consider using the insider version of the images. For more information, see "Base images for Windows insiders" below.
  • Do you need GPU acceleration support for your container workloads? If yes, you should consider using the Windows Server image to include hardware acceleration for your Windows containers workloads.

Tip

Many Windows users want to containerize applications that have a dependency on .NET. In addition to the four base images described here, Microsoft publishes several Windows container images that come pre-configured with popular Microsoft frameworks, such as a the .NET framework image and the ASP .NET image.

Windows vs Windows Server

The Windows Server image (3.1 GB) is slightly smaller in size from the Windows image (3.4 GB). The Windows Server image also inherits all the performance and reliability improvements from the Server Core image, has GPU support, and has no limits for IIS connections. To use the latest Windows Server image, you'll need a Windows Server 2022 installation. The Windows image is not available for Windows Server 2022.

Base images for Windows Insiders

Microsoft provides "insider" versions of each container base image. These insider container images carry the latest and greatest feature development in our container images. When you're running a host that is an insider version of Windows (either Windows Insider or Windows Server Insider), it is preferable to use these images. The following insider images are available on Docker Hub:

Read Use Containers with the Windows Insider Program to learn more.

Windows Server Core vs Nanoserver

Windows Server Core and Nanoserver are the most common base images to target. The key difference between these images is that Nanoserver has a significantly smaller API surface. PowerShell, WMI, and the Windows servicing stack are absent from the Nanoserver image.

Nanoserver was built to provide just enough API surface to run apps that have a dependency on .NET core or other modern open source frameworks. As a tradeoff to the smaller API surface, the Nanoserver image has a significantly smaller on-disk footprint than the rest of the Windows base images. Keep in mind that you can always add layers on top of Nano Server as you see fit. For an example of this check out the .NET Core Nano Server Dockerfile.