Docs: Add troubleshooting for OpenSSL build errors#1731
Docs: Add troubleshooting for OpenSSL build errors#1731Vikash-Kumar-23 wants to merge 2 commits intopython:mainfrom
Conversation
Adds the --with-openssl-rpath=auto flag to help resolve "Python requires a OpenSSL 1.1.1 or newer" errors on Linux/WSL. Fixes python#1727.
|
All commit authors signed the Contributor License Agreement. |
Documentation build overview
82 files changed ·
|
willingc
left a comment
willingc
left a comment
There was a problem hiding this comment.
Thanks @Vikash-Kumar-23 for the submission.
@hugovk @encukou I would like a second pair of eyes on this recommendation as it's out of my Windows expertise. Thanks.
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
|
It's also out of my expertise, and out of DiR scope as WSL isn't a supported platform. I'll not get to it before the 3.15 feature freeze, sorry! |
|
I'm also not a Windows/WSL user, I use Homebrew to install OpenSSL on macOS. |
|
@brettcannon Any thoughts on this PR? |
I've never failed to get OpenSSL to work under WSL. I think mentioning WSL is a red herring as there's nothing inherent to it that would prevent OpenSSL from working; it would be a Linux distro issue if anything failed or just a bad build of OpenSSL. And our general instructions on how to get build dependencies at https://devguide.python.org/getting-started/setup-building/#build-dependencies cover that. |
|
Thanks @brettcannon for the detailed response 😄 @Vikash-Kumar-23 I'm going to close this PR based on Brett's feedback. Thanks. |
5 participants
This PR adds documentation for the --with-openssl-rpath=auto flag to the Unix build instructions in setup-building.rst.
Technical Context
On several modern Linux distributions and WSL environments, the CPython ./configure script can fail to link the SSL module correctly, even when a compatible OpenSSL version is present. This typically results in the error: Could not build the ssl module! Python requires a OpenSSL 1.1.1 or newer.
Using the --with-openssl-rpath=auto flag ensures the build system correctly identifies the runtime search path for OpenSSL, allowing the _ssl extension to build successfully.
Related Issue
Fixes #1727