diff options
Diffstat (limited to 'sites/www/installing.rst')
| -rw-r--r-- | sites/www/installing.rst | 41 |
1 files changed, 31 insertions, 10 deletions
diff --git a/sites/www/installing.rst b/sites/www/installing.rst index bb1addc8..51f317dc 100644 --- a/sites/www/installing.rst +++ b/sites/www/installing.rst @@ -2,6 +2,13 @@ Installing ========== + +.. note:: + These instructions cover Paramiko 2.0 and above. If you're looking to + install Paramiko 1.x, see :doc:`installing-1.x`. However, **the 1.x line + relies on insecure dependencies** so upgrading is strongly encouraged. + + .. _paramiko-itself: Paramiko itself @@ -37,16 +44,17 @@ for the last 2-3 releases including the latest stable one. This typically spans major & minor versions, so even if e.g. 3.1 is the latest stable release, it's likely that bugfixes will occasionally come out for the -latest 2.x and perhaps even 1.x releases, as well as for 3.0. +latest 2.x and perhaps even 1.x releases, as well as for 3.0. New feature +releases for previous major-version lines are less likely but not unheard of. -If you're unsure which version to install, we have suggestions: +If you're unsure which version to install: * **Completely new users** should always default to the **latest stable release** (as above, whatever is newest / whatever shows up with ``pip install paramiko``.) -* **Users upgrading from a much older version** (e.g. the 1.7.x line) should - probably get the **oldest actively supported line** (check the - :ref:`changelog` for recent releases). +* **Users upgrading from a much older version** (e.g. 1.7.x through 1.10.x) + should probably get the **oldest actively supported line** (check the + :doc:`changelog` for recent releases). * **Everybody else** is hopefully already "on" a given version and can carefully upgrade to whichever version they care to, when their release line stops being supported. @@ -57,9 +65,9 @@ If you're unsure which version to install, we have suggestions: Cryptography ============ -`Cryptography <https://cryptography.io>`_ provides the low-level (C-based) +`Cryptography <https://cryptography.io>`__ provides the low-level (C-based) encryption algorithms we need to implement the SSH protocol. It has detailed -`installation instructions <crypto-install>`_ (and an `FAQ +`installation instructions`_ (and an `FAQ <https://cryptography.io/en/latest/faq/>`_) which you should read carefully. In general, you'll need one of the following setups: @@ -69,10 +77,17 @@ In general, you'll need one of the following setups: Cryptography & its dependencies. * On Linux, or on other platforms with older versions of ``pip``: you'll need a C build toolchain, plus development headers for Python, OpenSSL and CFFI. - Again, see `Cryptography's install docs <crypto-install>`_; these - requirements may occasionally change. + Again, see `Cryptography's install docs`_; these requirements may + occasionally change. -.. _crypto-install: https://cryptography.io/en/latest/installation/ + .. warning:: + If you go this route, note that **OpenSSL 1.0.1 or newer is effectively + required**. Cryptography 1.3 and older technically allow OpenSSL 0.9.8, but + 1.4 and newer - which Paramiko will gladly install or upgrade, if you e.g. + ``pip install -U`` - drop that support. + +.. _installation instructions: +.. _Cryptography's install docs: https://cryptography.io/en/latest/installation/ .. _gssapi: @@ -99,3 +114,9 @@ due to their infrequent utility & non-platform-agnostic requirements): delegation, make sure that the target host is trusted for delegation in the active directory configuration. For details see: http://technet.microsoft.com/en-us/library/cc738491%28v=ws.10%29.aspx + + +.. toctree:: + :hidden: + + installing-1.x |