diff --git a/docs/faq.rst b/docs/faq.rst index 7eec9c53b427..4123a1cf8461 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -123,7 +123,9 @@ Installing ``cryptography`` fails with ``error: Can not find Rust compiler`` Building ``cryptography`` from source requires you have :ref:`Rust installed and available` on your ``PATH``. You may be able to fix this by upgrading to a newer version of ``pip`` which will install a pre-compiled -``cryptography`` wheel. If not, you'll need to install Rust. +``cryptography`` wheel. If not, you'll need to install Rust. Follow the +:ref:`instructions` to ensure you install a recent Rust +version. For the current release *only* you can temporarily bypass the requirement to have Rust installed by setting the ``CRYPTOGRAPHY_DONT_BUILD_RUST`` environment diff --git a/docs/installation.rst b/docs/installation.rst index 9f7eb1d7d75b..e3de10340a7c 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -273,6 +273,8 @@ Building ``cryptography`` requires having a working Rust toolchain. The current minimum supported Rust version is 1.45.0. Instructions for installing Rust can be found on `the Rust Project's website`_. +We recommend installing Rust with ``rustup`` (as documented by the Rust +Project) in order to ensure you have a recent version. .. _`Homebrew`: https://brew.sh .. _`MacPorts`: https://www.macports.org diff --git a/setup.py b/setup.py index 0142faccea85..7e19d38e5c31 100644 --- a/setup.py +++ b/setup.py @@ -169,7 +169,10 @@ instructions for your platform. 3) Check our frequently asked questions for more information: https://cryptography.io/en/latest/faq.html - 4) Ensure you have a recent Rust toolchain installed. + 4) Ensure you have a recent Rust toolchain installed: + https://cryptography.io/en/latest/installation.html#rust + 5) If you are experiencing issues with Rust for *this release only* you may + set the environment variable `CRYPTOGRAPHY_DONT_BUILD_RUST=1`. =============================DEBUG ASSISTANCE============================= """ )