Confluence Retirement

Due to the feedback from stakeholders and our commitment to not adversely impact USGS science activities that Confluence supports, we are extending the migration deadline to January 2023.

In an effort to consolidate USGS hosted Wikis, myUSGS’ Confluence service is targeted for retirement. The official USGS Wiki and collaboration space is now SharePoint. Please migrate existing spaces and content to the SharePoint platform and remove it from Confluence at your earliest convenience. If you need any additional information or have any concerns about this change, please contact Thank you for your prompt attention to this matter.
Skip to end of metadata
Go to start of metadata

(warning) Currently, this document is merely notes about the setup in Pro as we learn more about it. Feel free to contribute!

Conda and pip SSL certificate

DOI is now requiring SSL, when using Conda you are likely to get a warning that SSL certificates are not valid. The following steps will get you set up to use SSL so Conda will work:

1. Download to your default Downloads folder

2. Set up the certificate to use it with Conda and pip

mkdir %USERPROFILE%\.certificates
copy %USERPROFILE%\Downloads\DOIRootCA.crt %USERPROFILE%\.certificates
conda config --set ssl_verify %USERPROFILE%\.certificates\DOIRootCA.crt
mkdir %USERPROFILE%\pip
echo [global] > %USERPROFILE%\pip\pip.ini
echo cert = %USERPROFILE%\.certificates\DOIRootCA.crt >> %USERPROFILE%\pip\pip.ini

Using Conda in ArcGIS Pro

As you may have heard, ArcGIS Pro 1.3 includes Conda with Pro's install package. 

Required Reading: Pro Help: Python in ArcGIS Pro

This is a fully functional install of Conda with a virtual environment set up that system administrators can update to add and remove Python packages with pip and conda. Users can also set up their own virtual environments (even for Desktop to use) but for Desktop to use those environments you will have to follow the guidance posted in Using Anaconda modules from the ESRI python environment (of course, ignoring the Conda install instructions).

Unfortunately, at this time, to make full use of Pro's Conda, you need admin access. This will be fixed soon (Pro v2.1 early 2018).

Accessing Conda

When you install Pro 1.3, you get a shortcut in the start menu to launch Conda:


Conda shell

The Python Command Prompt link starts a Conda shell and activates the ArcGIS Pro virtual environment

This shortcut runs the script:


If you run it as a regular user, you get an error message that warns you can't update anything.

(However, you can run conda commands, see below.)


Access is denied.
Could Not Find C:\ArcGIS\Pro\bin\Python\envs\arcgispro-py3\proenv.txt
Insufficient privileges to use Conda. Please open a Python Command Prompt session
with administrative privileges by right clicking on the link and selecting "Run as Administrator".
Activating environment "C:\ArcGIS\Pro\bin\Python\envs\arcgispro-py3"...
[arcgispro-py3] C:\ArcGIS\Pro\bin\Python\envs\arcgispro-py3>conda env list
# conda environments:
arcgispro-py3         *  C:\ArcGIS\Pro\bin\Python\envs\arcgispro-py3
root                     C:\ArcGIS\Pro\bin\Python

[arcgispro-py3] C:\ArcGIS\Pro\bin\Python\envs\arcgispro-py3>


Python prompt

The Python Interactive Terminal link starts Python using the ArcGIS Pro virtual environment.

This shortcut runs the script:



Python 3.4.4 |Continuum Analytics, Inc.| (default, Feb 16 2016, 09:54:04) [MSC v.1600 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> import sys
>>> print(sys.prefix)
>>> print(sys.executable)


IDE setup

To set up an IDE to develop code intended to be started from tbx and pyt: y, use this executable:


ArcGIS Pro default Python environment

Here are the details on what is included in the Conda environment Pro is using. 


C:\ArcGIS\Pro\bin\Python\Scripts>conda env list
# conda environments:
arcgispro-py3            C:\ArcGIS\Pro\bin\Python\envs\arcgispro-py3
root                  *  C:\ArcGIS\Pro\bin\Python

C:\ArcGIS\Pro\bin\Python\Scripts>activate arcgispro-py3
Activating environment "C:\ArcGIS\Pro\bin\Python\envs\arcgispro-py3"...

[arcgispro-py3] C:\ArcGIS\Pro\bin\Python\Scripts>conda list
# packages in environment at C:\ArcGIS\Pro\bin\Python\envs\arcgispro-py3:
arcgispro                 1.3                           1    http://twofish/win-
colorama                  0.3.6                    py34_0    defaults
future                    0.15.2                   py34_0    defaults
matplotlib                1.4.3                np19py34_0    defaults
msvc_runtime              1.0.1                    vc10_0  [vc10]  defaults
nose                      1.3.7                    py34_0    defaults
numpy                     1.9.3                   py34_0e  [arcgispro]  esri
openssl                   1.0.2h                   vc10_0  [vc10]  defaults
pandas                    0.17.1               np19py34_0    esri
pip                       8.1.1                    py34_1    defaults
py                        1.4.31                   py34_0    defaults
pyparsing                 2.1.1                    py34_0    defaults
pypdf2                    1.25.1                     py_0    esri
pytest                    2.9.1                    py34_0    defaults
python                    3.4.4                         4    defaults
python-dateutil           2.5.3                    py34_0    defaults
pytz                      2016.4                   py34_0    defaults
requests                  2.9.1                    py34_0    defaults
scipy                     0.16.1              np19py34_0e  [arcgispro]  esri
setuptools                20.7.0                   py34_0    defaults
six                       1.10.0                   py34_0    defaults
sympy                             py34_0    defaults
vs2010_runtime            10.00.40219.1                 0    defaults
wheel                     0.29.0                   py34_0    defaults
xlrd                      0.9.4                    py34_0    defaults
xlwt                      1.0.0                    py34_0    defaults


When you try to update packages using Conda, you get an error message if you're not logged with elevated privileges:


[arcgispro-py3] C:\ArcGIS\Pro\bin\Python\Scripts>conda install xlwt python=3.4 --dry-run
Fetching package metadata: ......
Solving package specifications: .........

Package plan for installation in environment C:\ArcGIS\Pro\bin\Python\envs\arcgispro-py3:

The following packages will be downloaded:

    package                    |            build
    python-3.4.5               |                0        22.9 MB
    xlwt-1.1.2                 |           py34_0         158 KB
                                           Total:        23.1 MB

The following packages will be UPDATED:

    python: 3.4.4-4      --> 3.4.5-0      (copy)
    xlwt:   1.0.0-py34_0 --> 1.1.2-py34_0 (copy)

Error: Missing write permissions in: C:\ArcGIS\Pro\bin\Python
# You don't appear to have the necessary permissions to install packages
# into the install area 'C:\ArcGIS\Pro\bin\Python'.
# However you can clone this environment into your home directory and
# then make changes to it.
# This may be done using the command:
# $ conda create -n my_arcgispro-py3 --clone=C:\ArcGIS\Pro\bin\Python\envs\arcgispro-py3


UPDATE I found that the above command does not work for me when logged in as regular user because I do not have access to the envs folder.


  • No labels