From 20ad71ef7a9cf1811538c345bd4afa12aa545e7a Mon Sep 17 00:00:00 2001 From: Vikash Kumar <163628932+Vikash-Kumar-23@users.noreply.github.com> Date: Sun, 8 Feb 2026 21:39:49 +0530 Subject: [PATCH 1/2] Docs: Add troubleshooting for OpenSSL build errors Adds the --with-openssl-rpath=auto flag to help resolve "Python requires a OpenSSL 1.1.1 or newer" errors on Linux/WSL. Fixes #1727. --- getting-started/setup-building.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/getting-started/setup-building.rst b/getting-started/setup-building.rst index 110d718e95..662da859dd 100644 --- a/getting-started/setup-building.rst +++ b/getting-started/setup-building.rst @@ -197,6 +197,16 @@ Configuration is typically:: More flags are available to ``configure``, but this is the minimum you should do to get a pydebug build of CPython. +.. note:: + **Could not build the ssl module!** + + If the build fails with an error stating ``Python requires a OpenSSL 1.1.1 or newer`` + despite having it installed, try using the following configuration flag: + + .. code-block:: bash + + ./configure --with-openssl-rpath=auto + .. note:: You might need to run ``make clean`` before or after re-running ``configure`` in a particular build directory. From 77a25b59ae986a4a105134d097cd88ac9365ccae Mon Sep 17 00:00:00 2001 From: Vikash Kumar <163628932+Vikash-Kumar-23@users.noreply.github.com> Date: Thu, 16 Apr 2026 21:51:17 +0530 Subject: [PATCH 2/2] Update getting-started/setup-building.rst Co-authored-by: Carol Willing --- getting-started/setup-building.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/getting-started/setup-building.rst b/getting-started/setup-building.rst index 662da859dd..958e883ec0 100644 --- a/getting-started/setup-building.rst +++ b/getting-started/setup-building.rst @@ -198,10 +198,10 @@ More flags are available to ``configure``, but this is the minimum you should do to get a pydebug build of CPython. .. note:: - **Could not build the ssl module!** + **Could not build the ssl module** - If the build fails with an error stating ``Python requires a OpenSSL 1.1.1 or newer`` - despite having it installed, try using the following configuration flag: + If the build fails with an error stating ``Python requires OpenSSL 1.1.1 or newer`` + when OpenSSL is installed, try using the following configuration flag: .. code-block:: bash