https://github.com/python/cpython/commit/2f1276cbce13bceb02b693c5cddfcbf0f75d6345 commit: 2f1276cbce13bceb02b693c5cddfcbf0f75d6345 branch: 3.15 author: Miss Islington (bot) <[email protected]> committer: hugovk <[email protected]> date: 2026-09-11T18:08:19Z summary:
[3.15] Add documentation on PyManager proxy setting overrides (GH-156768) (#157288) Co-authored-by: Steve Dower <[email protected]> Co-authored-by: Hugo van Kemenade <[email protected]> files: M Doc/using/windows.rst diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst index 5bec0c57b12214b..3423617c2870ccc 100644 --- a/Doc/using/windows.rst +++ b/Doc/using/windows.rst @@ -934,6 +934,37 @@ checking for that feed. } +Proxy settings +-------------- + +.. versionadded:: 26.4 + +By default, the Python install manager will use your system-wide proxy settings, +including automatic authentication. For most users, this behaves the same as +your browser and other applications. + +To override the settings, use the ``NO_PROXY``, ``HTTP_PROXY`` and +``HTTPS_PROXY`` environment variables. These should be set in the terminal +session before using the Python install manager. Other applications may also +use the variables, so use caution before setting them globally for your entire +machine. + +Setting ``NO_PROXY`` to any non-empty value will disable the use of any proxy. +Use this to bypass your system's default proxy setting and attempt to access the +index server directly. + +Setting ``HTTPS_PROXY`` to a string like ``example.com:8080`` will connect to +that proxy server for all HTTPS connections. For the default index, all +connections will be using HTTPS, and so this is the usual setting to override. + +The ``HTTP_PROXY`` variable may be needed if you are using a private index +server that does not use encrypted connections, but does require the default +proxy server to be overridden. It follows the same format as ``HTTPS_PROXY``. + +Credentials may be embedded in either setting, however, when ``HTTPS_PROXY`` has +credentials embedded they will be used in preference to other credentials. Only +one set of credentials will be used for both types of proxy. + .. _pymanager-troubleshoot: Troubleshooting _______________________________________________ Python-checkins mailing list -- [email protected] To unsubscribe send an email to [email protected] https://mail.python.org/mailman3//lists/python-checkins.python.org Member address: [email protected]
