Skip To Content

Deploying an extension

Before you can use any extension (SOE or SOI) that you develop, you need to deploy it to your ArcGIS Server site. You can do this in ArcGIS Server Manager.


Beginning at 10.4, only administrators can deploy an extension. To allow publishers to deploy extensions, see Change geoprocessing service and service extension publishing privileges.

To deploy an extension, you need to get the .soe file that was created by the extension developer. The .soe file can contain one or many extensions. Once you have the .soe file, perform the following steps:

  1. Log in to ArcGIS Server Manager and click Site.
  2. Click Extensions > Add Extension.
  3. Click Browse and browse to the .soe file.
  4. Click Add.

When you finish these steps, the .soe file is uploaded into the server system directory. The extensions contained in the file are registered and initialized with the ArcGIS Server site. Other GIS servers included in the site will automatically detect the deployed extensions.


If you're deploying an extension and it fails to initialize in the site, the service associated with the extension will start and be available for use. If the extension is an SOE or the service relies on extension behavior from an SOI, clients will see failures if they attempt to consume the service.

If you're implementing an SOI that provides security-related functionality, avoid any initialization logic that may lead to failures. If a failure occurs, the service associated with the extension will be exposed to clients without the security functionality enabled.