Install Docker Enterprise Edition for Windows Server

Estimated reading time: 3 minutes

Docker Enterprise Edition for Windows Server (Docker EE) enables native Docker containers on Windows Server. Windows Server 2016 and later versions are supported. The Docker EE installation package includes everything you need to run Docker on Windows Server. This topic describes pre-install considerations, and how to download and install Docker EE.

Release notes

You can get release notes for all versions here

Install Docker EE

Docker EE for Windows requires Windows Server 2016 or later. See What to know before you install for a full list of prerequisites.

  1. Open a PowerShell command prompt, and type the following commands.

    Install-Module DockerMsftProvider -Force
    Install-Package Docker -ProviderName DockerMsftProvider -Force
    
  2. Check if a reboot is required, and if yes, restart your instance:

    (Install-WindowsFeature Containers).RestartNeeded
    

    If the output of this command is Yes, then restart the server with:

    Restart-Computer
    
  3. Test your Docker EE installation by running the hello-world container.

    docker container run hello-world:nanoserver
    
    Unable to find image 'hello-world:nanoserver' locally
    nanoserver: Pulling from library/hello-world
    bce2fbc256ea: Pull complete
    3ac17e2e6106: Pull complete
    8cac44e17f16: Pull complete
    5e160e4d8db3: Pull complete
    Digest: sha256:25eac12ba40f7591969085ab3fb9772e8a4307553c14ea72d0e6f98b2c8ced9d
    Status: Downloaded newer image for hello-world:nanoserver
    
    Hello from Docker!
    This message shows that your installation appears to be working correctly.
    

(optional) Make sure you have all required updates

Some advanced Docker features, such as swarm mode, require the fixes included in KB4015217 (or a later cumulative patch).

sconfig

Select option 6) Download and Install Updates.

Install a specific version

To install a specific Docker version, you can use the MaximumVersion,MinimumVersion or RequiredVersion flags. For example:

Install-Package -Name docker -ProviderName DockerMsftProvider -Force -RequiredVersion 17.06.2-ee-5
...
Name                           Version          Source           Summary
----                           -------          ------           -------
Docker                         17.06.2-ee-5       Docker           Contains Docker EE for use with Windows Server 2016...

Update Docker EE

To update Docker EE on Windows Server 2016:

Install-Package -Name docker -ProviderName DockerMsftProvider -Update -Force

If Docker Universal Control Plane (UCP) is installed, run the UCP installation script for Windows.

Start the Docker service:

Start-Service Docker

What to know before you install

About Docker EE containers and Windows Server

Looking for information on using Docker EE containers?

Where to go next

  • Getting started provides an overview of Docker for Windows, basic Docker command examples, how to get help or give feedback, and links to all topics in the Docker for Windows guide.

  • FAQs provides answers to frequently asked questions.

  • Release Notes lists component updates, new features, and improvements associated with Stable and Edge releases.

  • Learn Docker provides general Docker tutorials.

  • Windows Containers on Windows Server is the official Microsoft documentation.

Windows, Windows Server, install, download, ucp, Docker EE