Skip To Content

Configure ArcGIS Notebook Server after installation (Linux containers)

When your ArcGIS Notebook Server installation is complete, run the post installation 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 post installation 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: ./PostInstallUtility.sh -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: ./PostInstallUtility.sh -d
  5. If Docker Desktop is not installed, install it now.
  6. Install your Notebooks image by specifying its file path. The image should be zipped in the .tar.gz format. If you have an Advanced license and Docker Desktop, run the command twice to install both the Standard and Advanced container images you downloaded from My Esri.
    Note:

    Ensure that your machine has at least 75 GB of available disk space.

    Run the following command: ./PostInstallUtility.sh -l <path of .tar.gz Docker image>

    Note:
    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.