Install container engine for ArcGIS Notebook Server (Linux containers)

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

There are two editions of Docker available for Linux systems: Docker Engine Community and Mirantis Container Runtime.

If you're running Ubuntu or Red Hat Enterprise Linux Server, you can use either Docker edition.

Docker edition	Operating system	Notebook runtime (Container) image type
Docker Engine Community edition 25.0.0 or later	Ubuntu Server LTS 20.04 Ubuntu Server LTS 22.04 Red Hat Enterprise Linux Server 8 update 8 Red Hat Enterprise Linux Server 9 update 2 Rocky Linux 9 update 2 AlmaLinux 9 update 2	Linux
Mirantis Container Runtime version 23.0.10 or later	Ubuntu Server LTS 20.04 Ubuntu Server LTS 22.04 Red Hat Enterprise Linux Server 8 update 8 Red Hat Enterprise Linux Server 9 update 2 Oracle Linux 9 update 2 Oracle Linux 8.6	Linux

Note:

Because Docker is a third-party software component, this topic does not detail the complete steps to install Docker. Review and refer to the Docker website for the most up-to-date information.

Install Mirantis Container Runtime on Red Hat Enterprise Linux Server, Ubuntu, and Oracle Linux

To install Mirantis Container Runtime, you must obtain a trial or subscription for the software.

1. Uninstall any previous version of Docker on your machine.

   Refer to the Docker documentation for that version for complete uninstall steps.

2. Follow the steps in your Linux distribution's Mirantis Container Runtime install guide.

   Note:

   Currently Mirantis does not have a separate install guide for Rocky Linux, but the Red Hat Enterprise Linux install guide can be followed for installation on Rocky Linux.

   Note:

   The documents outlines the two methods you can use to install the software (from a Docker repository or through an RPM package).

3. Since Docker does not automatically start after installation and configuration, start the Docker daemon by running the following command:
   $ sudo systemctl start docker

4. Verify that Docker is properly installed and can access container images by running the following command:
   $ sudo docker run hello-world

Proceed to the Configure Docker settings and environments section below.

Install Docker Engine Community on Red Hat Enterprise Linux Server or AlmaLinux

The Docker Engine Community edition is a free download but requires that you have a Docker account.

1. Uninstall any previous version of Docker on your machine.

   Refer to the Docker documentation for that version for complete uninstall steps.

2. Follow the steps in Get Docker CE for CentOS.

   The document outlines the two methods you can use to install the software (from a Docker repository or through a DEB package).

   The Docker daemon starts automatically after installation.

3. Verify that Docker is properly installed and can access container images by running the following command:
   $ sudo docker run hello-world

Proceed to the Configure Docker settings and environments section below.

Install Docker Engine Community on Ubuntu

The Docker Engine Community edition is a free download but requires that you have a Docker account.

1. Uninstall any previous version of Docker on your machine.

   Refer to the Docker documentation for that version for complete uninstall steps.

2. Follow the steps in Get Docker CE for Ubuntu.

   The document outlines the two methods you can use to install the software (from a Docker repository or through a DEB package).

   The Docker daemon starts automatically after installation.

3. Verify that Docker is properly installed and can access container images by running the following command:
   $ sudo docker run hello-world

Proceed to the Configure Docker settings and environments section below.

Install Docker Engine Community on Rocky Linux

The Docker Engine Community edition is a free download but requires that you have a Docker account.

1. Uninstall any previous version of Docker on your machine.

   Refer to the Docker documentation for that version for complete uninstall steps.

2. Follow the steps in the Rocky Linux Docker guide.

   The Docker daemon starts automatically after installation.

3. Verify that Docker is properly installed and can access container images by running the following command:
   $ sudo docker run hello-world

Proceed to the Configure Docker settings and environments section below.

Configure Docker settings and environments

When the appropriate Docker edition is installed on your machine, configure Docker for use with ArcGIS Notebook Server.

1. Add your OS user account (or the account used to install ArcGIS Notebook Server) to the group named docker, which was automatically created at installation.

   $ sudo usermod -aG docker <ArcGIS Notebook Server install account>

2. Sign out and sign back in to the OS user account for the changes to take effect, and verify that you can run Docker commands from the account.

   $ docker run hello-world

   Docker uses the /var directory as its local registry for container images. During the upgrade process for subsequent releases, new images will be copied to the /var directory as well. To avoid running out of disk space during future upgrades, ensure that the /var directory has at least 75 GB of disk space.

3. Edit /etc/docker/daemon.json.

   Note:

   If this file does not exist, create it.

4. Set data-root to a local directory on your machine.

   {"data-root" : "/data/docker"}

5. Remove /var/lib/docker and create a hard link that refers to /data/docker.

   $ rm -rf /var/lib/docker
   $ ln -s /data/docker /var/lib/docker

6. Restart Docker.

   $ systemctl stop docker.service
   $ systemctl start docker.service

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