Using Insider Container Images

This exercise will walk you through the deployment and use of the Windows container feature on the latest insider build of Windows Server from the Windows Insider Preview program. During this exercise, you will install the container role and deploy a preview edition of the base OS images. If you need to familiarize yourself with containers, you can find this information in About Containers.

This quick start is specific to Windows Server containers on the Windows Server Insider Preview program. Please familiarize yourself with the program before continuing this quick start.

Prerequisites:

  • Become a part of the Windows Insider Program and review the Terms of Use.
  • One computer system (physical or virtual) running the latest build of Windows Server from the Windows Insider program and/or the latest build of Windows 10 from the Windows Insider program.

It is required that you use a build of Windows Server from the Windows Server Insider Preview program, or a build of Windows 10 from the Windows Insider Preview program, to use the base image described below. If you are not using one of these builds, the use of these base images will result in failure to start a container.

Install Docker Enterprise Edition (EE)

Docker EE is required in order to work with Windows containers. Docker EE consists of the Docker engine and the Docker client.

To install Docker EE, we'll use the OneGet provider PowerShell module. The provider will enable the containers feature on your machine and install Docker EE - this will require a reboot. Open an elevated PowerShell session and run the following commands.

Note: Installing Docker EE with Windows Server Insider builds requires a different OneGet provider than the one used for non-Insider builds. If Docker EE and the DockerMsftProvider OneGet provider are already installed remove them before continuing.

Stop-Service docker
Uninstall-Package docker
Uninstall-Module DockerMsftProvider

Install the OneGet PowerShell module for use with Windows Insider builds.

Install-Module -Name DockerProvider -Repository PSGallery -Force

Use OneGet to install the latest version of Docker EE Preview.

Install-Package -Name docker -ProviderName DockerProvider -RequiredVersion Preview

When the installation is complete, reboot the computer.

Restart-Computer -Force

Install Base Container Image

Before working with Windows containers, a base image needs to be installed. By being part of the Windows Insider program, you can also test our latest builds for the base images. With the Insider base images, there are now 4 available base images based on Windows Server. Refer to the table below to check for what purposes each should be used:

Base OS Image Usage
microsoft/windowsservercore Production and Development
microsoft/nanoserver Production and Development
microsoft/windowsservercore-insider Development only
microsoft/nanoserver-insider Development only

To pull the Nano Server Insider base image run the following:

docker pull microsoft/nanoserver-insider

To pull the Windows Server Core insider base image run the following:

docker pull microsoft/windowsservercore-insider

Please read the Windows Containers OS Image EULA which can be found here – EULA, and the Windows Insider program Terms of Use which can be found here – Terms of Use.

Next Steps

Build and run an application with or without .NET Core 2.0 or PowerShell Core 6