Add better documentation for "proxy"

[guettli]

If you search for "proxy" in the docs, you get no result. Just one News entry contains this word.

http://www.pip-installer.org/en/latest/search.html?q=proxy&check_keywords=yes&area=default

There needs to be a documentation how to use pip behind a proxy.

[carljm]

Indeed - patch welcome!

[pnasrat]

There are some great docs here, which I've asked if we can rework into pip. Mainly to cover cases for those using proxies with SCM tool

http://laurii.info/2010/11/using-pip-behind-proxy/comment-page-1/#comment-16345

[qwcode]

the latest version returns something for a search on "proxy", a hit on the global --proxy option
http://www.pip-installer.org/en/latest/usage.html?highlight=proxy

is there anything more to it than using this option?
we could add another example to the pip install examples section (which has 21 entries and growing now)
http://www.pip-installer.org/en/latest/usage.html?#examples

[pekkaklarck]

Having a section explaining how to use pip behind a proxy would be great. I love how pip makes installing packages easy and as a result also makes it easier to distribute packages. The problem for me is that lot of my users work in corporate environments and are behind proxies.

Currently only --proxy option is briefly documented, but there are also other ways how to make proxy work. I'm willing to write and contribute better documentation, but the problem is that I don't know how pip handles proxies in different situations myself. Below are some questions related to this:

1. What environment variables are supported? http_proxy, https_proxy, both, or something else?

2. Is pip able to sniff proxy configuration automatically from system configs on Windows and OSX? That's supported by urllib2, but I'm not certain does pip use it anymore.

3. How to configure proxy when installing pip itself? Do ez_setup.py and get-pip.py support proxies somehow?

[lock]

This thread has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.