Install ArcGIS Notebook Server on the same machine with a Base ArcGIS Enterprise deployment on Windows

Last Published: September 12, 2023


When installing ArcGIS Notebook Server on Windows, the installation of Docker Desktop causes entries to be written to the machine's hosts file that could cause problems with the way our software interprets the machine name.

This installation method assumes that all system requirements are met, keeping in mind that all minimum system requirements (CPU, RAM, storage) for each component are additive to maintain a supported environment.

Docker Desktop installed on a Windows machine writes entries to the system's hosts file that use the machine IP address to identify both host.docker.internal and gateway.docker.internal. This could potentially be picked up by other components of ArcGIS Enterprise, Portal for ArcGIS, ArcGIS Server, ArcGIS Notebook Server, and ArcGIS Data Store, and not only cause a name change in the software's definition of the machine but also cause auxiliary issues in how ArcGIS Server and ArcGIS Data store communicate.

The following image shows an example hosts file following Docker Desktop installation:

image of hosts file


As a precaution, to prevent the components of ArcGIS Enterprise from using the incorrect machine name for configuration and communication (due to the host file entry made by installing Docker Desktop), follow the instructions for each component to define the hostname to the software before installation of Docker Desktop.

This includes adding an entry for in the created file for ArcGIS Enterprise Portal, ArcGIS Server, and ArcGIS Notebook Server, as well as adding an entry in the file for for ArcGIS Data Store.

Ideally, this would be done before creating each of the respective sites, but can also be performed after configuration if the machine names are confirmed in the Admin > Machine endpoints for ArcGIS Portal and ArcGIS Server.

Documentation can be found in the Related Information section below, in the 'Multiple NICs or DNS entries' sub-heading for each product.

Article ID:000022812

  • Enterprise

Receive notifications and find solutions for new or common issues

Get summarized answers and video solutions from our new AI chatbot.

Download the Esri Support App

Related Information

Discover more on this topic

Get help from ArcGIS experts

Contact technical support

Download the Esri Support App

Go to download options