Install Docker for ArcGIS Notebook Server—ArcGIS Enterprise

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 Desktop Community and Mirantis Container Runtime. 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) that your machine runs as follows:

If you're running Red Hat Enterprise Linux, only Mirantis Container Runtime 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 Mirantis Container Runtime on Red Hat Enterprise Linux

To install Mirantis Container Runtime, 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 steps to uninstall the specific version.
Follow the steps in Get Mirantis Container Runtime 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.
Run the following command to start the Docker daemon:
```
$ sudo systemctl start docker
```
Run the following command to verify that Docker is properly installed and can access container images:
```
$ sudo docker run hello-world
```

Proceed to the Configure Docker settings and environments section.

Install Mirantis Container Runtime on Ubuntu

To install Mirantis Container Runtime, 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 steps to uninstall the specific version.
Follow the steps in Get Mirantis Container Runtime 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 starts automatically after installation.
Run the following command to verify that Docker is properly installed and can access container images:
```
$ sudo docker run hello-world
```

Proceed to the Configure Docker settings and environments section.

Install Docker Desktop Community on Ubuntu

The Docker Desktop Community edition is a free download but you must have a Docker account.

Uninstall any previous version of Docker installed on your machine.
Refer to the Docker documentation for steps to uninstall the specific version.
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 starts automatically after installation.
Run the following command to verify that Docker is properly installed and can access container images:
```
$ 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.

Add your OS user account (or the account used to install ArcGIS Notebook Server) to the group called docker, which should have been automatically created upon installation.
```
$ sudo usermod -aG docker <ArcGIS Notebook Server install account>
```
Log out and log 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 50 GB of disk space.
Optionally, 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?