Install Docker for ArcGIS Notebook Server—ArcGIS Notebook Server Installation Guide (10.7)

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 Docker Engine Enterprise. ArcGIS Notebook Server supports both Red Hat Enterprise Linux and Ubuntu operating systems. The Docker edition you should use depends on the operating system (OS) your machine runs as follows:

If you're running Red Hat Enterprise Linux, only Docker Engine Enterprise is supported by ArcGIS Notebook Server.
If you're running Ubuntu, you can use either Docker edition. See Docker and ArcGIS Notebook Server for more information about which edition is appropriate for your deployment.

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 Docker Engine Enterprise on Red Hat Enterprise Linux

To install Docker Engine Enterprise, you need to obtain a trial or subscription for the software.

Uninstall any previous version of Docker installed on your machine.
Refer to the Docker documentation for that version for complete uninstall steps.
In a browser, go to the Docker Enterprise (Red Hat Enterprise Linux) download page in the Docker Hub store.
Sign in to your Docker account with an existing trial or subscription, or sign up for one now.
Follow the steps in Get Docker EE for Red Hat Enterprise Linux.
That document outlines the two methods you can use to install the software (from a Docker repository or via an RPM package).
Docker does not automatically start after installation and configuration. Start the Docker daemon by running the following command:
```
$ sudo systemctl start docker
```
Verify that Docker is properly installed and can pull container images by running the following command:
```
$ sudo docker run hello-world
```

Proceed to the Configure Docker settings and environments section.

Install Docker Engine Enterprise on Ubuntu

To install Docker Engine Enterprise, you need to obtain a trial or subscription for the software.

Uninstall any previous version of Docker installed on your machine.
Refer to the Docker documentation for that version for complete uninstall steps.
In a browser, go to the Docker Enterprise (Ubuntu) download page in the Docker Hub store.
Sign in to your Docker account with an existing trial or subscription, or sign up for one now.
Follow the steps in Get Docker EE for Ubuntu.
That document outlines the two methods you can use to install the software (from a Docker repository or via a DEB package).
The Docker daemon should start automatically after installation.
Verify that Docker is properly installed and can pull container images by running the following command:
```
$ sudo docker run hello-world
```

Proceed to the Configure Docker settings and environments section.

Install Docker Engine Community on Ubuntu

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

Uninstall any previous version of Docker installed on your machine.
Refer to the Docker documentation for that version for complete uninstall steps.
In a browser, go to the Docker Engine - Ubuntu (Community) download page in the Docker Hub store.
Sign in to your Docker account, or sign up for one now.
Follow the steps in Get Docker CE for Ubuntu.
That document outlines the two methods you can use to install the software (from a Docker repository or via a DEB package).
The Docker daemon should start automatically after installation.
Verify that Docker is properly installed and can pull container images by running the following command:
```
$ sudo docker run hello-world
```

Proceed to the Configure Docker settings and environments section.

Configure Docker settings and environments

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

Follow the post-installation steps for Linux in the Docker documentation.
These steps add your OS user account (or the account used to install ArcGIS Notebook Server) to a Unix group named docker.
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 50 GB of disk space.
To change the directory Docker uses to store container images from /var/lib/docker to another directory, enter the commands below into a terminal (note that the commands will stop and restart Docker). In the following commands, the new target directory is /data/docker:
1. systemctl stop docker.service
2. mkdir /data/docker
3. chmod 755 /var/lib/docker
4. mv /var/lib/docker /data/docker
5. ln -s /data/docker /var/lib/docker
6. systemctl start docker.service

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

Feedback on this topic?