Activate an environment

Activate a conda environment using the Package Manager page.

Environment state

The following describes environment states within ArcGIS Pro and their impacts:

  • Default—The default ArcGIS Pro conda environment is arcgispro-py3. This environment cannot be modified.
  • Active—The conda environment from which the Python interpreter within ArcGIS Pro will initialize. Any package changes (add, update, or remove) are applied to this environment. The active environment is indicated by a green checkmark Active on the Environment Manager dialog box, and is displayed by name in the Active Environment text box on the Package Manager page.
  • Initialized—If Python is started from within ArcGIS Pro, the active environment is initialized for the remainder of the session. Python can be started within ArcGIS Pro by any functionality that uses Python, including but not limited to the Python window, Notebooks or the Geoprocessing pane. This is indicated by a Python Interpeter icon Package next to the environment name in the Environment Manager dialog box. Other environments can be activated and modified, but the Python interpreter is locked to this environment until ArcGIS Pro is restarted. If a different environment is activated, restart ArcGIS Pro to switch to this environment.

Activate an environment from the Package Manager page

To activate an environment from the Package Manager page, do the following:

  1. On the ribbon, click the Project tab.

    The settings page appears.

  2. In the list of side tabs, click Package Manager.

    The Package Manager page appears.

  3. Click the Activate Environment pull-down menu and select an environment.

    If the only environment listed is the default arcgispro-py3 environment, see Clone an environment to create another environment.

The environment is activated.

Activate an environment from the Environment Manager dialog box

To activate an environment from the Environment Manager dialog box, do the following:

  1. On the ribbon, click the Project tab.

    The setting page appears.

  2. In the list of side tabs, click Package Manager.

    The Package Manager page appears.

  3. Click the Environment Manager button Manage.

    The Environment Manager dialog box appears.

  4. Double-click a row representing the environment you want to activate.

    Alternatively, right-click the row representing the environment, and select Activate or click the row's options button, and select Activate.

The environment is activated.

Related topics