Install Docker Enterprise Edition for Windows ServerEstimated reading time: 4 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.
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.
Open a PowerShell command prompt, and type the following commands.
Install-Module DockerMsftProvider -Force Install-Package Docker -ProviderName DockerMsftProvider -Force
Check if a reboot is required, and if yes, restart your instance:
If the output of this command is Yes, then restart the server with:
Test your Docker EE installation by running the
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.
(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).
6) Download and Install Updates.
Use 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.
In a PowerShell command prompt, download the installer archive on a machine that has a connection.
# On an online machine, download the zip file. invoke-webrequest -UseBasicparsing -Outfile docker-17.06.2-ee-16.zip https://download.docker.com/components/engine/windows-server/17.06/docker-17.06.2-ee-16.zip
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.
#Stop Docker service Stop-Service docker # Extract the archive. Expand-Archive docker-17.06.2-ee-16.zip -DestinationPath $Env:ProgramFiles -Force # Clean up the zip file. Remove-Item -Force docker-17.06.2-ee-16.zip # Install Docker. This requires rebooting. $null = Install-WindowsFeature containers # Add Docker to the path for the current session. $env:path += ";$env:ProgramFiles\docker" # Optionally, modify PATH to persist across sessions. $newPath = "$env:ProgramFiles\docker;" + [Environment]::GetEnvironmentVariable("PATH", [EnvironmentVariableTarget]::Machine) [Environment]::SetEnvironmentVariable("PATH", $newPath, [EnvironmentVariableTarget]::Machine) # Register the Docker daemon as a service. dockerd --register-service # Start the Docker service. Start-Service docker
Test your Docker EE installation by running the
docker container run hello-world:nanoserver
Install a specific version
There are currently two channels available for Docker EE for Windows Server:
17.06- Use this version if you’re using Docker Enterprise Edition (Docker Engine, UCP, DTR).
17.06is the default.
18.03- Use this version if you’re running Docker EE Engine alone.
To install a specific version, use the
Install-Package -Name docker -ProviderName DockerMsftProvider -Force -RequiredVersion 18.03 ... Name Version Source Summary ---- ------- ------ ------- Docker 18.03.1-ee-2 Docker Contains Docker EE for use with Windows Server...
Updating the DockerMsftProvider
Installing specific Docker EE versions may require an update to previously installed DockerMsftProvider modules. To update:
Then open a new Powershell session for the update to take effect.
Update Docker EE
To update Docker EE Engine to the most recent release, specify the
Install-Package -Name docker -ProviderName DockerMsftProvider -RequiredVersion 18.03 -Update -Force
Preparing a Docker EE Engine for use with UCP
Run the UCP installation script for Windows.
Start the Docker service:
What to know before you install
- What the Docker EE for Windows install includes: The installation provides Docker Engine and the Docker CLI client.
About Docker EE containers and Windows Server
Looking for information on using Docker EE containers?
Getting Started with Windows Containers (Lab) provides a tutorial on how to set up and run Windows containers on Windows 10 or Windows Server 2016. It shows you how to use a MusicStore application with Windows containers.
Setup - Windows Server 2016 (Lab) describes environment setup in detail.
Docker Container Platform for Windows Server articles and blog posts on the Docker website.
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.