https://github.com/python/cpython/commit/8f847875d60c81841e18a20510257a6e1b45b146
commit: 8f847875d60c81841e18a20510257a6e1b45b146
branch: main
author: Steve Dower <[email protected]>
committer: zooba <[email protected]>
date: 2026-09-10T22:21:15+01:00
summary:
Add documentation on PyManager proxy setting overrides (GH-156768)
files:
M Doc/using/windows.rst
diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst
index 3a32c193e3a8fc8..5dfc16fe68b26d5 100644
--- a/Doc/using/windows.rst
+++ b/Doc/using/windows.rst
@@ -943,6 +943,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]
