Skip To Content

Install Docker for ArcGIS Notebook Server

The steps below describe how to download, install, and configure the Docker container allocation software required by ArcGIS Notebook Server. See Docker and ArcGIS Notebook Server for an introduction to Docker and how it's used in ArcGIS Notebook Server.

Download and install Docker

The Docker edition needed to run ArcGIS Notebook Server on Windows is Docker Engine Community. This is accessible through the Docker Desktop for Windows application. Follow these steps to install Docker on your machine.

  1. Verify that Hyper-V is installed on your Windows machine by searching for the Hyper-V Manager application. If it's not, install it before proceeding. See the following Microsoft documentation for steps:
  2. In a browser, go to the Docker Desktop (Windows) download page in the Docker Hub store.
  3. Sign in to your existing Docker Hub account, or sign up for a new account.
  4. Download the Docker Desktop software.
  5. Double-click Docker for Windows Installer to run it.
  6. On the Configuration dialog box of the installer, you will be prompted on whether Docker should use Windows containers. Do not select this option; ArcGIS Notebook Server requires Linux containers.
  7. Close the installer when it has completed.
  8. Click the Docker Desktop button in the Start menu to start Docker.
  9. Verify that Docker has started using one of the following methods:
    • Check the status of the Docker icon in the Windows system tray (usually located at the bottom-right corner of your screen).
    • Open the command prompt window and run the following commands:
      docker version
      docker run hello-world
      The first command provides the version of Docker on your machine; the second verifies that Docker can pull and run container images.

Configure Docker settings

After Docker is installed on your machine, modify the settings described below.

Port 2375

You'll use the Docker Remote API, which requires the use of port 2375.

  1. Right-click the Docker button in the Windows system tray, and click Settings.
  2. On the General page, check Expose daemon on tcp://localhost:2375 without TLS.

    You may receive a security warning.

Local drive

The Docker container needs access to your local drive.

  1. Right-click the Docker button in the Windows system tray, and click Settings.
  2. From the settings menu, click Shared Drives.
  3. Choose the drive that will be used for your ArcGIS Notebook Server configuration store.

    Note:

    Repeat this step whenever the credentials for your Run As account change. If you create a new account during ArcGIS Notebook Server installation, you'll be referred back to this step.

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