Install Mirantis Container Runtime for ArcGIS Notebook Server (Windows containers)

ArcGIS Notebook Server with Windows containers and Mirantis Container Runtime is available on Windows Server.

Docker is available as Mirantis Container Runtime (formerly Docker Engine-Enterprise).

Operating system	Docker edition	Notebook runtime (Container) image type	Additional requirements
Windows Server 2022 Standard and Datacenter	Mirantis Container Runtime version 23.0 or later	Windows	Hyper-V is optional. 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.

Note:

Mirantis Container Runtime is a third-party software component, and this topic may not provide the full process for installing it. See the Mirantis Container Runtime site for more information on its installation processes.

Install Mirantis Container Runtime

Follow the steps below to install Mirantis Container Runtime on your machine.

1. Uninstall any previous version of Docker on your machine.
2. Do not enable the Containers feature on your local server prior to installing Mirantis Container Runtime. If this feature is already enabled, disable it on your server machine. See Install or Uninstall Roles, Role Services, or Features in the Microsoft documentation for more information.
3. Follow the steps in Install Mirantis Container Runtime on Windows Server in the Mirantis documentation to obtain and run the install.ps1 installation script for Mirantis Container Runtime for Windows Server.

   To run the installation script, use the code below:

   ./install.ps1

4. Verify that Mirantis Container Runtime is installed and has been started by running the following command:
   docker run hello-world:nanoserver

5. Once completed, follow the steps below to configure Mirantis Container Runtime.

Configure Mirantis Container Runtime

To configure Mirantis Container Runtime, complete the following steps:

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.

You are now ready to install ArcGIS Notebook Server on your machine.