diff --git a/docs/upgrade.rst b/docs/upgrade.rst
index 25f67c7f..2648c4bb 100644
--- a/docs/upgrade.rst
+++ b/docs/upgrade.rst
@@ -2,6 +2,18 @@
 Upgrading
 #########
 
+0.9.0
+*****
+
+The 0.8.7 package on pypi was corrupted.  If upgrading from 0.8.7 to 0.9.0 please follow:
+
+.. code-block::
+
+    pip uninstall pymongo
+    pip uninstall mongoengine
+    pip install pymongo==2.8
+    pip install mongoengine
+
 0.8.7
 *****