Using Anaconda behind a company proxy¶
When using Anaconda with a company proxy, you may encounter an HTTP and SSL error due to custom security profiles managed by corporate IT departments.
There are 3 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
andhttps_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 runningconda 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
.
Read more about unsetting, listing, and persisting environment variables.
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.