diff --git a/cafe/plugins/sshv2/README.rst b/cafe/plugins/sshv2/README.rst
new file mode 100644
index 0000000..44a19b4
--- /dev/null
+++ b/cafe/plugins/sshv2/README.rst
@@ -0,0 +1,15 @@
+Notes about installation
+========================
+
+The sshv2 plugin requires Paramiko, which in the past relied on the pycrypto
+library.
+As of  Paramiko v2.0, the pycrypto library has been replaces with the
+Python Cryptographic Authority's cryptography library.  While this is a good
+change overall, some systems may be lacking the required libraries.
+
+This plugin will continue to use 1.17.0 for the near term, but will eventually
+switch to paramiko > 2, at which point it will be neccessary for users to
+upgrade their systems in order to install this plugin.
+
+For information about the transition from 1.17.0 to 2.0 and the involved
+changes, please see http://www.paramiko.org/changelog.html
diff --git a/cafe/plugins/sshv2/setup.py b/cafe/plugins/sshv2/setup.py
index fcfd382..caddb9e 100644
--- a/cafe/plugins/sshv2/setup.py
+++ b/cafe/plugins/sshv2/setup.py
@@ -20,10 +20,11 @@ setup(
     name='cafe_sshv2_plugin',
     version='0.0.1',
     description='Paramiko based plugin for OpenCAFE',
+    long_description='{0}'.format(open('README.rst').read()),
     author='Rackspace Cloud QE',
     author_email='cloud-cafe@lists.rackspace.com',
     url='http://rackspace.com',
     packages=find_packages(),
     namespace_packages=['cafe'],
-    install_requires=['paramiko', 'pysocks'],
+    install_requires=['paramiko<2', 'pysocks'],
     zip_safe=False)