Skip To Content

Welcome to the ArcGIS Notebook Server (Linux) installation guide

ArcGIS Notebook Server is an ArcGIS Server role that is licensed and configured for the purpose of hosting notebooks. The server role uses containers to host and run ArcGIS Notebooks and provides a separate and secure environment for the notebooks without interfering with the host operating system.

If your ArcGIS Notebook Server site has been set up, refer to the software user guide or administrator guide.

Multiple machines can be joined in an ArcGIS Notebook Server site, allowing you to expand your machine resources for hosting and running notebooks. To deploy a multiple-machine site, additional steps are required, as detailed in Join additional machines to an ArcGIS Notebook Server site.

Use this guide to install and configure the software. The installation process for ArcGIS Notebook Server is different from that for other ArcGIS Server roles. Read the installation guide carefully, and complete the installation steps in the order they are presented.

Software installation

An overview of the steps to install ArcGIS Notebook Server is below. Complete each step in order, and review all sections of the installation guide documentation as you go.

  • Read the following introductory material in this guide to become familiar with the software:
  • Complete your ArcGIS Enterprise base deployment. Whether you are upgrading from an earlier version or installing a new deployment, you must have all software components—the ArcGIS Enterprise portal, an ArcGIS Server site designated as the hosting server, and an instance of ArcGIS Data Store—installed and running the 11.3 software.
  • Review the system requirements and make any necessary adjustments to the machine you'll be using. Read the entire system requirements topic.
  • Obtain your materials from the My Esri website: the software installer and the container images corresponding to your license level.

    The ArcGIS Notebook Server Standard license is included with both the ArcGIS Enterprise Standard and Advanced licenses. The ArcGIS Notebook Server Advanced license requires an additional purchase.


    For users with a Standard license, download the Standard container image. For users with an Advanced license, download both the Standard and the Advanced container images.

  • Install the ArcGIS Notebook Server software on your machine. You can do this using the provided installer or install silently. There are separate help topics for these two options.
  • Configure your ArcGIS Notebook Server site (Linux containers). The three primary steps are as follows:
    • Create a site for your ArcGIS Notebook Server machine.
    • Add your OS account to a Docker group.
    • Run the post installation utility to configure Docker with ArcGIS Notebook Server.
  • Join any additional machines (Linux containers) to your new site. This help topic also explains other requisites for multiple-machine site setup.
  • Install and configure an instance of ArcGIS Web Adaptor with your ArcGIS Notebook Server site. To use a reverse proxy server with the site, there are instructions to do so as well.
  • Configure your site with your ArcGIS Enterprise portal. Federate the server site with the portal, and designate it as the portal's notebook server. This allows you to create ArcGIS Notebooks that run in your ArcGIS Notebook Server site. Finally, create one or more custom portal member roles to grant your notebook authors the necessary privileges.

In this topic
  1. Software installation