Skip To Content

Configure ArcGIS Notebook Server after installation

When your ArcGIS Notebook Server installation is complete, run the postinstallation utility to set up the necessary Docker components. Perform these steps for each machine on which you've installed ArcGIS Notebook Server.

Add your OS account to the Docker group

Add your OS user account (or the account used to install ArcGIS Notebook Server) to a Unix group named docker. See the Docker documentation for complete steps.

Run the postinstallation utility

ArcGIS Notebook Server includes a utility to be run after the software is installed. This utility installs the Docker container images for notebooks that you downloaded from My Esri.

Complete the following steps to run the utility before creating your ArcGIS Notebook Server site:

  1. Open a terminal using the ArcGIS Notebook Server installation account.
  2. Change directories to the ArcGIS Notebook Server tools folder. By default, this path is ${HOME}/arcgis/notebookserver/tools/postInstallUtility.
  3. Optionally refer to the utility's help by running the following command: > ./ -h
  4. ArcGIS Notebook Server requires Docker Engine to be installed on your machine. Determine whether Docker is active on your machine by running the following command: ./ -d
  5. If Docker is not installed, install it now.
  6. Install your Docker image by specifying its file path. The image should be zipped in the .tar.gz format. If you have an Advanced license, run the command twice to install both the Standard and Advanced container images you downloaded from My Esri. Run the following command: > ./ -l <path of .tar.gz Docker image>

    Ensure you install both container images. Even if you have the Advanced license, your users may still need to use the Standard runtime.

Proceed to create an ArcGIS Notebook Server site.