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] 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 110d718e9..662da859d 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.