Skip To Content

ArcGIS Enterprise configuration

Before ArcGIS Enterprise users can create projects and manage mobile workers through Workforce for ArcGIS, you need to set up ArcGIS Enterprise and install Workforce for ArcGIS on your Windows or Linux machine.


To install Workforce on ArcGIS Enterprise, you need ArcGIS Enterprise 10.5.1 or later, including the following components, either on the same machine or separately in a distributed environment:

Supported versions

While Workforce is supported on ArcGIS Enterprise 10.5.1 or later, the version of Workforce that is supported varies based on your version of ArcGIS Enterprise.

  • ArcGIS Enterprise 10.5.1 supports Workforce 17.0.1.
  • ArcGIS Enterprise 10.6 supports Workforce 18.0.1.
  • ArcGIS Enterprise 10.6.1 supports Workforce 18.0.2.

Download the setup

Download the Workforce setup to install it on your machine.

  1. Sign in to the My Esri site with your Esri Account that is tied to your customer number.
  2. Click My Organizations and click Downloads.

    If you are a member of multiple organizations, make sure the name and customer number of the organization you want to work with display in the upper right corner. If they do not, click Organization List and choose a different organization before clicking Downloads.

    All the products that are available to you (based on your customer number) display.

  3. Find the ArcGIS Enterprise product and version that you want to deploy Workforce to, and click View Downloads—for example, ArcGIS Enterprise (Windows) 10.5.1 or ArcGIS Enterprise (Linux) 10.5.1.
  4. Expand the Apps section.
  5. Click Download for the Workforce for ArcGIS setup, and save it to your machine.

Install on Windows

Once you have met the requirements, take the following steps to install Workforce on a Windows machine:

  1. Browse to the location of the downloaded installation file, extract the archive file, and double-click the setup.exe file.

    The setup program detects the ArcGIS Enterprise components on your machine, verifying that you have Portal for ArcGIS. If it is not detected, the program closes.

  2. Follow the directions in the installation wizard. Make sure to read the license agreement and accept it, or exit if you do not agree with the terms.

    The default installation directory for the Workforce app is C:\Program Files\ArcGIS\Portal\apps.

Install on Linux

Once you have met the requirements, take the following steps to install Workforce on a Linux machine:

  1. Sign in to your machine as a user with administrative privileges.
  2. Browse to the location of the downloaded installation file and extract the archive file.
  3. Run the setup command.

Use Workforce

When the setup completes, you are ready to use Workforce. Use a browser and type the URL to Workforce, for example, (where host, domain, and webadaptor are replaced by the information about your portal). Click Resources in the app to access help.


Resources opens help on the Esri website, which always reflects the latest version of Workforce. If you are using an earlier version of Workforce, you can use help installed on your portal that is specific to your version of Workforce. The help local to your portal can be accessed by adding /help at the end of the URL to Workforce, for example,

Help was not installed with Workforce 17.0.1. Download a .zip file of the 17.0.1 help, extract the files, and copy the help folder to the apps/workforce folder on your portal.


If using ArcGIS Enterprise 10.6 or 10.6.1, you may also want to add Workforce to the app launcher. The app launcher is a convenient window from which organization members can open the apps available to them, but Workforce is not included by default. To enable it, do the following:

  • Using ArcGIS Enterprise 10.6—set the showWorkforce property in the portal's configuration file to true.
  • Using ArcGIS Enterprise 10.6.1—set the showInAppLauncher property in the portal's configuration file to include Workforce for ArcGIS.

See Set advanced portal options for details.


When a new version of Workforce for ArcGIS is available, upgrade to it by uninstalling your existing version and installing the new version. Your projects aren't affected or modified by this process.

If you upgrade ArcGIS Enterprise, you might need to upgrade Workforce for ArcGIS as well. Specific versions of Workforce for ArcGIS are supported on specific versions of ArcGIS Enterprise. See Supported versions. If you're using an installation of ArcGIS Enterprise 10.6 or earlier on a Linux machine, your installation of Workforce is automatically removed when you upgrade ArcGIS Enterprise. If you installed ArcGIS Enterprise on Windows, or if you installed ArcGIS Enterprise 10.6.1 or later on a Linux machine, you need to remove Workforce before installing the new version of Workforce. After upgrading ArcGIS Enterprise and Workforce for ArcGIS, you need to reindex your portal to see projects created before the upgrade.


If you no longer need to use Workforce for ArcGIS, you can uninstall it from ArcGIS Enterprise.

  1. Open the Control Panel and click Programs and Features.
  2. In the Programs list, right-click Workforce for ArcGIS and click Uninstall.