The system and hardware required to run Portal for ArcGIS are listed below. A diagnostics tool runs during the setup to help you determine if your machine meets the minimum system requirements.
If you will license ArcGIS Pro, ArcGIS Pro extensions, or ArcGIS Drone2Map through ArcGIS Enterprise, you also need ArcGIS License Manager 2020.0 or a later release to configure licenses to specify which members can use these apps. See the Portal for ArcGIS administrator guide, License Manager reference guide, and License Manager system requirements for more information.
It's recommended that you review the deprecation notice to determine if your hardware and software components are still compatible with the current ArcGIS version.
Linux operating system requirements
The following 64-bit operating systems satisfy the minimum operating system requirements. Support is not provided for 32-bit operating systems; the setup only proceeds if the operating system is 64 bit.
Portal for ArcGIS is only supported on Linux x86_64, on CPUs that adhere to the x86_64 architecture (64 bit), with supported Linux releases.
Machines with an underscore (_) in the name are not supported. The setup does not proceed if an underscore is detected in the machine name.
You cannot install the software as a root user. If you attempt to do this, the installation will not proceed and a diagnostics tool will display an error message indicating that you cannot install as root.
The software should not be installed on an OS (binary) that has been modified. Esri does not provide support for products installed on a developer's release of an operating system.
| Supported operating system | Latest update or service pack tested |
|---|---|
Red Hat Enterprise Linux Server 8 | Update 3 |
Red Hat Enterprise Linux Server 7 | Update 9 |
SUSE Linux Enterprise Server 15 | Service Pack 2 |
SUSE Linux Enterprise Server 12 | Service Pack 5 |
Ubuntu Server 20.04 LTS | 20.04.1 |
Ubuntu Server 18.04 LTS | 18.04.5 |
Prior and future updates or service packs for these operating system versions are supported unless otherwise stated. The operating system version and updates must also be supported by the operating system provider.
Note:
Esri Technical Support is available for CentOS, Scientific Linux, and Oracle Linux versions that provide full binary compatibility with an equivalent supported Red Hat Enterprise Linux Server version. As a prerequisite for logging a software defect, Esri Technical Support will attempt to reproduce the issue on Red Hat Enterprise Linux Server. For Oracle Linux, support is predicated on the use of the Red Hat Enterprise Linux Server compatible kernel.
| Supported operating system | Latest update or service pack tested |
|---|---|
CentOS Linux 8 | Update 3 |
CentOS Linux 7 | Update 9 |
Scientific Linux 7 | Update 9 |
Oracle Linux 8 | Update 3 |
Oracle Linux 7 | Update 9 |
Tip:
The X Window System package group is required on the machine to run the following using the operating system graphical user interface (GUI):
- Portal for ArcGIS installation wizard
- Check for Updates tool
The following package groups are required:
Red Hat Enterprise Linux Server
- gettext
SUSE Linux Enterprise Server
- gettext-runtime
Ubuntu Server LTS
- gettext-base
Hardware requirements
The following are the minimum hardware requirements to install Portal for ArcGIS:
- Processor: 2 cores minimum for development and testing, 4 cores minimum highly recommended for production systems
- Memory/RAM: 8 GB
- Disk space: 10 GB
All content created by your users will also be stored on disk. Carefully consider how data will be uploaded and created by your users and allocate disk space accordingly. If desired, you can change the location of where the portal stores its content after installing the software.
Temp space requirements
By default, resources are extracted to the system /tmp directory. This directory must have read, write, and execute permissions enabled. If the required space is not available in the /tmp directory, the setup program will attempt to extract resources to the user's HOME directory. If the required space is not available in the user's HOME directory, the setup program will report an error indicating this problem. Optionally, you can specify an alternate temp location by setting the IATEMPDIR environment variable.
File system requirements
On Linux systems, the ext3 file system limits the number of item subfolders to less than 32,000; this means your portal is limited to having no more than 32,000 items. No new items can be added to Portal for ArcGIS when this limit is reached. It is recommended that you update or move the installation directory to an ext4 or xfs file system that does not have this limitation. The file system must also be supported by the operating system provider.
Note:
The btrfs file system is supported only if adequate disk space is allocated for the metadata used by btrfs. Run the following command to confirm: btrfs filesystem df /File handle limits
For the portal to run properly, the file handle limits for the installation user are required to be set to a minimum of 65,535. An installation diagnostics tool will check whether the limits are set properly in the /etc/security/limits.conf file. If the limits are set incorrectly, the diagnostics check will fail.
There are soft and hard limits for file handles on Linux. To determine the limits, use the following commands:
- Soft limit: ulimit -Sn
- Hard limit: ulimit -Hn
To increase the soft and hard limits, edit the /etc/security/limits.conf file with superuser access. For example, add two lines in the file as follows:
<Portal for ArcGIS installation user> soft nofile <file handle limit>
<Portal for ArcGIS installation user> hard nofile <file handle limit>
After making this change, sign out and sign back in with the user for the new values to take effect. To verify that the limits have been modified appropriately, use the ulimit -Sn and ulimit -Hn commands as described above.
If you use SystemD to bootstrap starting and stopping the Portal for ArcGIS service, verify that DefaultLimitNOFILE and DefaultLimitNPROC limits in the /etc/systemd/system.conf file are set to 65536 and 25059 respectively
Firewall settings
Portal for ArcGIS communicates through specific ports. You'll need to open these ports on your firewall before installing the software. For information on the ports Portal for ArcGIS requires for communication, see Ports used by Portal for ArcGIS.
Domain name service and fully qualified domain name requirements
Your organization's domain name service (DNS) must include an entry of the fully qualified domain name (FQDN) of the machine hosting Portal for ArcGIS. Similarly, if you'll be using ArcGIS Server with your portal, it's recommended that you include FQDN entries for each site you intend to federate with Portal for ArcGIS.
Note:
Portal for ArcGIS only supports a single DNS.
Optionally, you can configure your DNS to use a friendly name for the portal (for example, friendly.domain.com instead of portal.domain.com). When doing this, assign the name to the portal machine before you install the software. Then use the friendly name when setting up the portal. For example, setup activities that require use of the friendly name include the following:
- Configure ArcGIS Web Adaptor with your portal.
- Federate an ArcGIS Server site with your portal.
- Add Portal for ArcGIS to your organization's reverse proxy server. If you're not using a reverse proxy server, it's recommended that you assign a friendly name to the machine hosting ArcGIS Web Adaptor.
Caution:
If you configure a friendly DNS name after setting up your portal, existing items in the portal may become unusable, as they will include the nonfriendly name. You'll need to manually re-create each item to use them again.
SSL certificates
Portal for ArcGIS is configured with a self-signed server certificate, which allows you to do initial testing of the portal and helps you quickly verify that your installation was successful. You must request a certificate from a trusted certificate authority (CA) and configure the portal to use it. The certificate can be signed by a corporate (internal) or commercial CA.
You should configure each applicable ArcGIS component in your organization with a certificate from a corporate or commercial CA. Common examples include ArcGIS Web Adaptor and ArcGIS Server. For example, ArcGIS Server includes a configured self-signed certificate. If you'll be federating an ArcGIS Server site with your portal, it's very important that you request a CA-signed certificate and configure the ArcGIS Server site and Web Adaptor to use it.
For more information, see Security best practices.
ArcGIS Web Adaptor
ArcGIS Web Adaptor is a required component of Portal for ArcGIS that allows you to integrate your portal with your existing web server and your organization's security mechanisms. You cannot deploy Portal for ArcGIS in your organization without the Web Adaptor.
You can only use the Web Adaptor with port 80 or 443. Using other ports is not supported. See the ArcGIS Web Adaptor documentation for details.
Supported web browsers
For the best performance in the portal website, use the latest versions of the browsers listed below. The website leverages the local storage capabilities (similar to cookies) of the browser. If this storage is disabled, the site will not function properly. To learn how to enable local storage, consult the browser's documentation.
- Google Chrome
- Microsoft Edge
- Mozilla Firefox
- Safari
- Android Browser
- Chrome for Android
Scene Viewer has its own browser and hardware requirements. Some of the apps used with ArcGIS Enterprise have different requirements. See their documentation for details.
External access
If you'll be using services provided by Esri, such as basemaps, ArcGIS Living Atlas of the World content, and data from ArcGIS Online, the machine hosting Portal for ArcGIS must have access to the internet. If your portal will not have access to the internet, you'll need to perform some additional configuration steps to ensure that your portal is pointing to local resources. For instructions, see Configure a disconnected deployment.
The machine hosting Portal for ArcGIS must also have access to the internet to use distributed collaboration with an ArcGIS Online organization.
Supported virtualization environments and cloud platforms
Virtualization and cloud environment support is the same for all components of a base ArcGIS Enterprise deployment. See ArcGIS Enterprise on cloud platforms and Supported virtualization environments in ArcGIS Enterprise system requirements for details.