Customizing environment definitions

As Admin or Editor of a project, you can change the name, the description, and the hardware configuration of an environment definition that you created. You cannot change the language of an existing environment definition.

If certain libraries are not included in the standard collection of pre-installed libaries and packages, you can customize the software configuration and add your own custom libraries or additional packages. You can change the software customization that you made at any time, or remove it completely.

Currently, you can only customize the software configuration of a standard default environment definition that you created. You can’t customize the software configuration of a Spark or a GPU environment definition you created.

To customize an environment definition you created:

  1. Click your project’s Environments tab.
  2. In the Active environment runtimes section, check that no runtime is active for the environment definition you want to change.
  3. In the Environment definitions section, click the environment definition you want to customize.
  4. Add your changes. For a default environment definition, you can create a customization and enter the packages you want to add to the standard preinstalled. You can also upgrade or downgrade packages that are part of the standard software configuration. The libraries that are added to an environment definition through the customization aren’t persisted; however, they are preinstalled each time the environment runtime is started.

    You must use the provided template to add libraries. There is a different template for Python and for R. The following example shows you how to add Python packages:

     # Please add conda channels here
     channels:
     - defaults
    
     # Please add conda packages here
     dependencies:
     - spacy=2.0.9
    
     # Please add pip packages here
     # To add pip packages, please comment out the next line
     - pip:
       - scikit-image==0.13.1
    

    You cannot add arbitrary notebook extensions as a customization because notebook extensions must be preinstalled. The only notebook extensions which can be enabled are the Esri ArcGIS extension and its prerequisites. When you create a runtime environment definition with the Python 3.5 software configuration, you can select to enable Esri ArcGIS. Note that you can only use the preinstalled version.

  5. Apply your changes.

Learn more

Installing custom Python packages