Skip To Content

Advanced settings for ArcGIS Notebook Server

In most cases, the default settings and parameters of your ArcGIS Notebook Server site ensure adequate system performance. Starting at 10.8, ArcGIS Notebook Server Manager allows you to change some advanced settings governing your site and its Docker component. As an administrator, you can modify settings to improve system performance, increase site limits, or accommodate your organization's IT practices. Be sure you understand each setting and its effects before making changes to the default values.

Settings available in Server Manager

The following site settings can be viewed and changed in ArcGIS Notebook Server Manager:

  • Web Socket Size (MB)—The maximum size (in megabytes) of a packet that can be passed between the server and client browsers using the WebSocket protocol. ArcGIS Notebook Server uses WebSocket to facilitate efficient, secure two-way communication with clients. The default value of this property is 16 MB. You may need to raise this limit if a particularly large piece of data is being passed by a notebook to the server site.
  • Max Containers Per Node—This property limits the number of containers that can be opened interactively at one time per ArcGIS Notebook Server machine. The default value is 20 containers; after the limit is reached, additional containers cannot be opened. Containers that are opened for automated running using the executeNotebook operation have their own limit property and do not count toward this limit.
  • Idle Notebook Threshold—This property governs when idle notebooks are closed. Notebooks that are open but have been inactive for this amount of time (in minutes) are automatically closed. The notebook's kernel is stopped. The default is 1440 (24 hours). You may want to lower this value if you have many authors and limited server resources.
  • Container Created Threshold—This property sets how long a container can remain open (in minutes) without running any active notebooks. After this value is reached, the container is automatically closed. The default is 60 minutes. As with the idle notebook threshold, you may want to reduce this value to conserve resources.

View and change settings in Server Manager

Follow these steps to access the site settings.

  1. Sign in to your ArcGIS Enterprise portal as an administrator and open ArcGIS Notebook Server Manager.
  2. Open the Settings page, and click Site.

    If you change any of the setting values, the Save button becomes available.

  3. Click to save your edits.

The ArcGIS Notebook Server site will restart.