Install Docker Enterprise Edition for Windows Server 2016

Estimated reading time: 3 minutes

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

Already have Docker EE for Windows? If you already have Docker EE for Windows installed, and you’re ready to get started, skip to Get started with Docker for Windows for a quick tour of the command line, settings, and tools.

Looking for Release Notes? Get release notes for all versions here or subscribe to the releases feed on the Docker Blog.

Install Docker EE

Docker EE for Windows requires Windows Server 2016. See What to know before you install for a full list of prerequisites. To install Docker Community Edition (Docker CE) on a Windows 10 machine, see Install Docker for Windows.

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

    PS> Install-Module -Name DockerMsftProvider -Force
    PS> Install-Package -Name docker -ProviderName DockerMsftProvider -Force
    PS> Restart-Computer -Force
    
  2. Test your Docker EE installation by running the hello-world container.

    PS> docker 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.
    <snip>
    

Using a script to install Docker EE

Use the following steps when you want to install manually, script automated installs, or install on air-gapped systems.

  1. In a PowerShell command prompt, download the installer archive on a machine that has a connection.

    # On an online machine, download the zip file.
    PS> invoke-webrequest -UseBasicparsing -Outfile docker.zip https://download.docker.com/components/engine/windows-server/17.03/docker-17.03.0-ee.zip
    
  2. Copy the zip file to the machine where you want to install Docker. In a PowerShell command prompt, use the following commands to extract the archive, register, and start the Docker service.

    # Extract the archive.
    PS> Expand-Archive docker.zip -DestinationPath $Env:ProgramFiles
    
    # Clean up the zip file.
    PS> Remove-Item -Force docker.zip
    
    # Install Docker. This will require rebooting.
    $null = Install-WindowsFeature containers
    
    # Add Docker to the path for the current session.
    PS> $env:path += "$env:ProgramFiles\docker"
    
    # Optionally, modify PATH to persist across sessions.
    PS> $newPath = "$env:ProgramFiles\docker;" +
    [Environment]::GetEnvironmentVariable("PATH",
    [EnvironmentVariableTarget]::Machine)
    
    PS> [Environment]::SetEnvironmentVariable("PATH", $newPath,
    [EnvironmentVariableTarget]::Machine)
    
    # Register the Docker daemon as a service.
    PS> dockerd --register-service
    
    # Start the daemon.
    PS> Start-Service docker
    
  3. Test your Docker EE installation by running the hello-world container.

    PS> docker run hello-world:nanoserver
    

Install Docker EE using OneGet

If you want to install Docker EE by using OneGet, follow the steps described in Windows Containers on Windows Server.

What to know before you install

About Docker EE containers and Windows Server 2016

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