Skip To Content

About ArcGIS Web Adaptor

In this topic

ArcGIS Web Adaptor (Java Platform) on Linux is a required component of Portal for ArcGIS which 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.

The Web Adaptor is an application that runs in your existing website and forwards requests to the machine hosting Portal for ArcGIS. The Java Platform setup is compatible with Java EE servers such as WebSphere and WebLogic.

Benefits of the Web Adaptor

The Web Adaptor provides the following benefits:

  • Allows you to integrate Portal for ArcGIS with your organization's existing web server. By including a web server in your site, you gain the ability to host web applications that use your GIS services.

  • Allows you to use your organization's identity store and security policies at the web-tier level. You can also use Public Key Infrastructure (PKI) or any other identity store for which the web server has built-in or extensible support. This allows you to provide a single sign-on or other custom authentication experience when logging in to use services, web applications, and Portal for ArcGIS.

  • Allows you to expose Portal for ArcGIS through a site name other than the default arcgis.

  • Allows you to expose Portal for ArcGIS through port 80 or 443.


    You can only use the Web Adaptor with port 80 or 443. Using different ports is not supported.

Web Adaptor deployment scenarios

The Web Adaptor's version must always match the version of Portal for ArcGIS.

The Web Adaptor is platform independent of Portal for ArcGIS; therefore, the Web Adaptor you deploy does not have to match the operating system platform of your portal. For example, if your portal is running on Windows, you can deploy ArcGIS Web Adaptor (Java Platform) on Linux to work with Portal for ArcGIS.

Accessing your portal with the Web Adaptor installed

After installing and configuring the Web Adaptor, the URL that you use to access your portal will be in the format For example, if the machine hosting your Web Adaptor is named wa with the domain and your Web Adaptor is named arcgis, you'll access the portal using the URL

If you have configured your portal to use SSL for all communication, you should update the installed portal website and help shortcut URLs to use https instead of http; otherwise, you will see failures in your browser when attempting to access the original shortcut URLs.

The Web Adaptor setup experience

The Web Adaptor has its own setup and installation guide which is separate from the Portal for ArcGIS installation. You must install the Web Adaptor on a machine running a web server. This can be a machine already running Portal for ArcGIS or a separate machine.

To learn more about the setup experience, see An overview of implementing the Web Adaptor with Portal for ArcGIS.