Install Docker Engine from binaries (Windows containers)—ArcGIS Notebook Server | Documentation for ArcGIS Enterprise
Skip To Content

Install Docker Engine from binaries (Windows containers)

Introduced at 11.3, ArcGIS Notebook Server with Windows containers supports installing Docker Engine from binaries.

Requirements

Installing Docker Engine from binaries has the following requirements:

Operating systemDocker editionNotebook runtime (Container) image typeAdditional requirements

Windows Server 2022 Standard and Datacenter

Docker Engine - Community version 25.0.0 or later

Windows

Optionally, you can install Hyper-V.

Note:

There are limitations to the maximum number of containers that can run with Hyper-V isolation on Windows Server 2022 Standard.

See the Windows FAQ for more information.

Install Docker Engine from binaries

Complete the following steps to install Docker Engine from binaries:

  1. Uninstall any previous version of Docker on your machine.
  2. Disable the Containers feature on your local server if it is enabled.

    See the Microsoft documentation for more information.

  3. Enable the Windows Containers feature by running the following command in Windows Powershell with administrative privileges:

    Add-WindowsFeature Containers

  4. Follow the prompts to restart your machine.
  5. Verify the installation of the Containers feature by running the following command:

    Get-WindowsFeature Containers

  6. Follow the instructions in the Install server and client binaries on Windows section in the Docker documentation.
  7. Add the docker directory path, for example C:\Program Files\docker, to the environment path variables.
  8. Verify your installation and Docker daemon running status by running the following command:

    docker version

Configure Docker Engine

Complete the following steps to configure Docker Engine:

  1. If the account used to install ArcGIS Notebook Server is not part of the administrator group, perform the following steps:
    1. From the Start menu on your Windows machine, open the Computer Management application.
    2. On the left sidebar, expand the Local Users and Groups item, and open the Groups folder.
    3. Choose the docker-users group from the list of groups and double-click it.

      If a docker-users group does not already exist, create one.

    4. Click the Add button, locate the account you used to install ArcGIS Notebook Server, and choose it. Click OK to confirm.
    5. Click OK to close the group dialog box.
    6. Create a configuration file at C:\ProgramData\Docker\config\daemon.json to set a security group for Docker.
    7. Edit C:\ProgramData\Docker\config\daemon.json to add the docker-users group.

        
      {
        "group" : "docker-users"
      }

  2. Enable port 2375 to enable the use of the Docker remote API. This port will only be used internally by ArcGIS Notebook Server and should be protected from external use. To enable the port, open a command prompt as an administrator and run the following command:
    sc config docker binpath= "\"C:\Program Files\docker\dockerd.exe\" --run-service -H tcp://localhost:2375 -H npipe://"
  3. Restart Docker with the following command:

    net stop docker
    net start docker

  4. Once the Docker component is installed, restart your machine.

    Note:
    Each time you install or upgrade the Docker component, you must restart the machine.

Change the default Docker image installation location

To change the default Docker image installation location, follow the steps below:

  1. Edit the file at C:\ProgramData\docker\config\daemon.json.
  2. Set data-root to your chosen location on your local machine.

     {
    "data-root": "d:\\docker"
    }

  3. Restart Docker.