Skip to main content

Configure a disconnected deployment

If you're configuring ArcGIS Enterprise in an environment where there is no internet connection or internet access is prohibited by your organization, you must configure the organization accordingly by updating HTTPS settings, disabling external content, and configuring your own utility services. Refer to the Architecture Center for more information about working in secure or disconnected environments.

Configure HTTPS settings

When setting up your portal in a disconnected environment, you will need to ensure that the portal trusts certificates from your certifying authority. See Configure the portal to trust certificates from your certifying authority for details.

Point to local resources

The items that you'll need to point to local resources include your organization's utility services and website-specific properties. The utility service settings are configured through the portal. The website has its own configuration files, which you must modify. You must also disable any settings that reference external content.

You can configure your organization manually using the workflows in this section. Alternatively, you can set the disconnectedModeEnabled property of the organization settings.

Disable external content

Because some Esri content requires external access to the internet, you must disable the content to prevent requests to ArcGIS Online resources. See Disable external content for more information.

Once external content has been disabled, items that contain URLs to external sites will not be discoverable or returned in search results.

Configure custom basemaps

ArcGIS Enterprise organizations come preconfigured with a collection of basemaps from ArcGIS Online. These basemaps are not supported for use in a disconnected environment. Instead, create custom basemaps and configure your organization to offer these basemaps in the basemap gallery.

See Customize basemaps for details about creating and configuring custom basemaps in ArcGIS Enterprise.

ArcGIS Living Atlas content

ArcGIS Living Atlas is a collection of ready-to-use geographic content available from ArcGIS Online. It can be disabled from your portal for disconnected environments. However, you can still use ArcGIS Living Atlas boundary layer content in a disconnected environment by downloading files from My Esri and publishing them as feature layers.

Configure utility services to use local services

ArcGIS Enterprise organizations are configured to use utility services to perform various tasks, including printing maps, locating addresses, calculating areas, and more. In disconnected environments, utility services must point to local services. Whether configured by your organization or by default, some of your organization's utility services may be using a service from ArcGIS Online.

To verify whether any of your organization's utility services must be updated to point to a local service, complete the following steps:

  1. Sign in to the organization as an administrator or a member with privileges to manage the organization website.

  2. Click Organization and click Settings.

  3. Click the Utility services tab.

  4. Review the sources of each utility service and take note of any that point to a service from ArcGIS Online.

    Tip:

    You can also review utility services that use services from ArcGIS Online from the ArcGIS Online tab. However, understand that this is not a comprehensive list. Routing services from ArcGIS Online and services that do not require ArcGIS Online credentials are configured only from the Utility services tab.

To learn more about the requirements and steps for configuring utility services to use local services, see Configure utility services.

Adjust ArcGIS Online-originated features

Update the following website properties using the Portal Directory. To learn more, see Set advanced portal options.

  • extentService: "<URL to local service>",—The extent service is used to update or set the extent of a web map item on the Settings tab of the item page. By default, the extent service originates from ArcGIS Online. In a disconnected environment, configure your organization to use a locally accessible dynamic map service, tiled map service, or vector tile service. It is recommended that the service use the WGS84 geographic coordinate system (WKID 4326) or the Web Mercator projected coordinate system (WKID 3857/102100).

  • portalAGOConfigEnabled: true,—Controls the display of the ArcGIS Online tab in the organization's Settings page. In a disconnected environment, set this property to false.

  • portalLivingAtlasConfigEnabled: true,—Controls the display of the Living Atlas tab in the organizations' Settings page. In a disconnected environment, follow the steps to disable access to Living Atlas content in your organization, then set this property to false.

  • searchArcGISOnlineEnabled: false,—With this property, you can disable the option in Map Viewer to search for and add layers from ArcGIS Online. The default is true. When disabled, the options to search for and add layers from ArcGIS Online will be hidden in Map Viewer.

Disable social media links

Because Facebook and X links require external access to the internet, you must disable the option to include social media links on item and group pages. By default, this option is disabled. If this option was enabled after installation, complete the following steps to disable it:

  1. Sign in to the organization as an administrator or member with privileges to manage the organization website.

  2. Click Organization and click Settings.

  3. Click the Security tab.

  4. In the Sharing and searching section under Policies, turn off the toggle button for Show social media links on item and group pages.

Configure the ArcGIS Maps SDK for JavaScript

The ArcGIS Maps SDK for JavaScript provides a CDN build that can be downloaded and hosted on a local web server. In a disconnected deployment, a locally hosted CDN build is required when using ArcGIS Notebook Server map widgets and can be used with locally hosted custom JavaScript or HTML applications.

Note:

ArcGIS Enterprise includes a version of the JavaScript Maps SDK for use by internal apps such as ArcGIS Dashboards. This version should not be used by locally hosted custom JavaScript or HTML applications.

Complete the following steps to install the CDN build of the JavaScript Maps SDK:

  1. Use the version matrix to identify the version of the JavaScript Maps SDK used by your version of ArcGIS Enterprise.

  2. Download the JavaScript Maps SDK that matches your version of ArcGIS Enterprise.

  3. Deploy the JavaScript Maps SDK to your web server accessible in your disconnected environment using the instructions in the install/README.md file included with the download.

  4. Configure the web server to register all required MIME types for the SDK resources.

  5. Configure the web server to support Cross-Origin Resource Sharing (CORS).

  6. Follow the instructions in README.md to validate the installation.

Configure ArcGIS Solutions

By default, the ArcGIS Solutions app uses solutions from ArcGIS Online. In disconnected environments, you can configure the app to instead use solution content imported into a group in your ArcGIS Enterprise organization.

To make solutions available, download and import the appropriate ArcGIS Solutions EPK into a group and configure that group for use by the ArcGIS Solutions app. For more information, see Configure the ArcGIS Solutions app for a disconnected deployment.

Install the Survey123 website

You can host your own version of the Survey123 website in a disconnected environment using the Survey123 website installer, which you download from My Esri. Each installation includes the following:

  • The Survey123 website for management of surveys and viewing of survey results.

  • The Survey123 REST API to convert survey configurations (.xlsx) to forms for use in the Survey123 field and web apps.

The Survey123 website can be installed on the same machine as your Portal for ArcGIS instance or on a stand-alone web server. For instructions, see Install ArcGIS Survey123.

Check for software patches and updates

You can check whether updates are available for ArcGIS Enterprise components using the patchnotification utility installed with the software. To download patches as appropriate, the utility requires access to these locations:

  • https://gisupdates.esri.com/

  • https://downloads.esri.com/

  • https://support.esri.com/

If your machine uses a forward proxy to access the internet, you'll need to specify the proxy server in the utility. For more information, see Check for and install software patches and updates.