Using Anaconda behind a company proxy#

When using Anaconda’s repositories with a company proxy, you may encounter an HTTP and SSL error due to custom security profiles managed by corporate IT departments.

CondaHTTPError: HTTP 000 CONNECTION FAILED for url https://repo.anaconda.com/pkgs/main/win-64/current_repodata.jsonElapsed:
An HTTP error occurred when trying to retrieve this URL.
HTTP errors are often intermittent, and a simple retry will get you on your way.
If your current network has https://www.anaconda.com blocked, please file
a support request with your network engineering team.
ConnectTimeout(MaxRetryError("HTTPSConnectionPool(host='repo.anaconda.com', port=443):
Max retries exceeded with url: /pkgs/main/win-64/current_repodata.json
(Caused by ConnectTimeoutError(<urllib3.connection.VerifiedHTTPSConnection object
at 0x000001B79FFE3278>, 'Connection to repo.anaconda.com timed out.
(connect timeout=9.15)'))"))

There are three potential ways to resolve this. Start with updating the .condarc file before trying the other methods.

Update the .condarc file#

Anaconda recommends updating your .condarc file to include the proxy_servers key. This is the preferred method because this will affect only conda and not the system environment variables.

Read more about the .condarc file and using proxies. For example:

proxy_servers:
    http: http://username:password@corp.com:8080
    https: https://username:password@corp.com:8080

You can see if your proxy is set by running conda info --all.

Environment variables#

You can also resolve this error by updating the system environment variables. This can affect all CLI software across the whole system.

Windows#

To change environment variables on Windows:

In the Start menu, search for “env”.
Select “Edit Environment Variables for your account”
Select “Environment Variables…”
Press “New…”
Add two variables http_proxy and https_proxy both with the same value: http://proxy-XX:XXX

MacOS#

To change environment variables on macOS:

Check the current environment variable settings by running printenv in the terminal.
To check a specific environment variable, use echo $variable_name.
Temporarily change the environment variables by running export variable_name=variable_value. You can check if it’s there by running conda info --all.

To change your environment variables on macOS permanently, review this guide.

Linux#

To change environment variables on Linux:

Run export variable_name=variable_value
To output the value of the environment variable from the shell, run echo $variable_name.

Netrc authentication#

A .netrc file is an alternate way to accomplish the same goal of setting the *_PROXY environment variables or configuring things only for conda in the .condarc file. The risk in this approach is that changing the environment variables here will affect the system settings as a whole.