Skip To Content
ArcGIS Developer
Dashboard

Upgrade apps

To upgrade apps created in a previous developer edition version of ArcGIS Web AppBuilder to a newer version, use the command utility.

  1. Stop all running instances of Web AppBuilder, if there are any.
  2. Open the command prompt window.
  3. Browse to the \server directory of your newer version of the Web AppBuilder installation.
  4. You have the option to upgrade an individual app or all of your apps.
    • To upgrade an individual app, type the following:
      • Type node_x64 upgrade < your_previous_version_Web_AppBuilder_installation_directory > <app_ id> for a 64-bit operating system, and press Enter.
      • Type node_x86 upgrade < your_previous_version_Web_AppBuilder_installation_directory > <app_ id> for a 32-bit operating system, and press Enter.
    • To upgrade all of your apps, type the following:
      • Type node_x64 upgrade < your_previous_version_Web_AppBuilder_installation_directory > for a 64-bit operating system, and press Enter.
      • Type node_x32 upgrade < your_previous_version_Web_AppBuilder_installation_directory > for a 32-bit operating system, and press Enter.

    Your previous version of the Web AppBuilder installation directory is similar to C:\arcgis-web-appbuilder-1.0. The app ID is 2 for the app at http://[your host name:port number]/webappbuilder/apps/2/.

  5. Once the upgrade is complete, start the new version of Web AppBuilder to check the result. You should see all your upgraded apps.

    If the upgrade failed, see the upgrade.log file in the \server\logs directory of the Web AppBuilder installation.

Running the command multiple times will upgrade and import apps multiple times into the new version of Web AppBuilder. This is by design.

If you have custom widgets and themes in the app that were created in the previous version of Web AppBuilder, the command utility will import them into the new version as well, without automatically checking them. You need to make sure these custom widgets are compiled with the version of ArcGIS API for JavaScript and version of Web AppBuilder to which you import the app. See the version comparison chart.