Specify a Python environment for all geoprocessing services

To deploy third-party Python packages with ArcGIS Server, use the following steps for each machine in your site:

1. Sign in to your ArcGIS Server machine with the ArcGIS Server account, and open the command prompt window as an administrator.
2. Change the directory to <install>\ArcGIS\Server\framework\runtime\ArcGIS\bin\Python\Scripts.
3. Clone the server's default Python environment with a new environment name, for example, newenvname, in the ArcGIS Server installation's Python environment directory with the command conda create --clone arcgispro-py3 --prefix "<install>\ArcGIS\Server\framework\runtime\ArcGIS\bin\Python\envs\newenvname". Replace the prefix with your installation directory and the new environment name.
4. To activate the cloned environment, run proswap newenvname.
5. Install the third-party Python packages by running conda install. Only use pip install if conda install is not available.
6. Restart the ArcGIS Server service on the Windows Task Manager Services tab or Windows Services. It will take a few minutes before all services are back online.
7. Repeat steps 1 through 6 on all other machines in your ArcGIS Server site for a multiple machine deployment.

To add more packages to the existing conda environment, follow these steps:

1. Sign in to your ArcGIS Server machine.
2. From the start menu, open the Python 3 Command Prompt. It may be in the ArcGIS Server folder, depending on your operating system.
3. Run conda install for the packages that need to be deployed. Only use pip install if conda install is not available.
4. Restart the geoprocessing service in ArcGIS Server Manager.
5. Optionally, restart the ArcGIS Server service on the Windows Task Manager Services tab. All services will be back online in a few minutes.
6. Repeat steps 1 through 5 on each machine in your ArcGIS Server site when you have a multiple machine deployment.

Specify a Python environment for a single geoprocessing service

Clone the server default Python environment, install third-party Python packages, and edit the service properties of your geoprocessing service using the following steps:

1. Sign in to your ArcGIS Server machine with the ArcGIS Server account, and open the command prompt window as an administrator.
2. Change the directory to <install>\ArcGIS\Server\framework\runtime\ArcGIS\bin\Python\Scripts.
3. Clone the server's default Python environment with a new environment name, for example, newenvname, in the ArcGIS Server installation's Python environment directory with the command conda create --clone arcgispro-py3 --prefix "<install>\ArcGIS\Server\framework\runtime\ArcGIS\bin\Python\envs\newenvname". Replace the prefix with your installation directory and the new environment name.
4. Activate the new environment in the command prompt window with activate newenvname.
5. Install your Python packages with conda install packagename=version. It is optional, but a best practice, to align the package version you used in ArcGIS Pro during the publishing process and the package version installed on the server.
6. Once all the packages are installed, go to the ArcGIS Server administrator directory. In Resources at the bottom of the page, go to services.
7. Select the geoprocessing service for which you want to specify a Python environment.
8. In Supported Operations at the bottom of the page, click edit.
9. In the service JSON, add the key value pair "condaEnvironmentPath": "<install>\\ArcGIS\\Server\\framework\\runtime\\ArcGIS\\bin\\Python\\envs\\newenvname" to the properties.

   Sample Service Properties showing limited key-values for illustrative purposes.

   {
    "serviceName": "gvonly",
    "type": "GPServer",
    "description": "",
    "allowedUploadFileTypes": "",
    "properties": {
     "toolbox": "C:\\arcgisserver\\directories\\arcgissystem\\arcgisinput\\gvonly.GPServer\\extracted\\p20\\gvonly.tbx",
     "condaEnvironmentPath": "C:\\Program Files\\ArcGIS\\Server\\framework\\runtime\\ArcGIS\\bin\\Python\\envs\\flaskonly"
    },
    "portalProperties": {
     "isHosted": false,
     "portalItems": [{
      "itemID": "4921223df97744a593d0b776666b9da9",
      "type": "GPServer"
     }]
    },
    "extensions": [{
     "typeName": "WPSServer",
     "properties": {
      "serviceType": "",
      "name": ""
     }
    }],
    "frameworkProperties": {},
    "datasets": []
   }

10. Click the Save Edits button to save your edits.
11. Your service restarts automatically.