summary refs log tree commit diff
path: root/README.rst
diff options
context:
space:
mode:
authorMark Haines <mark.haines@matrix.org>2015-09-07 14:57:00 +0100
committerMark Haines <mark.haines@matrix.org>2015-09-07 14:57:00 +0100
commit3ead04ceefc0d5a3ab207cabc2b17170229921ae (patch)
treea8548428d2db9a4c4b22e788761d491713d5f3e1 /README.rst
parentDEPENDENCY_LINKS was turned to a list (diff)
downloadsynapse-3ead04ceefc0d5a3ab207cabc2b17170229921ae.tar.xz
Add instructions for upgrading setuptools for when people encounter a message "mock requires setuptools>=17.1"
Diffstat (limited to 'README.rst')
-rw-r--r--README.rst6
1 files changed, 6 insertions, 0 deletions
diff --git a/README.rst b/README.rst
index 5b30ee3563..6c8431aa86 100644
--- a/README.rst
+++ b/README.rst
@@ -121,6 +121,7 @@ To install the synapse homeserver run::
 
     virtualenv -p python2.7 ~/.synapse
     source ~/.synapse/bin/activate
+    pip install --upgrade setuptools
     pip install --process-dependency-links https://github.com/matrix-org/synapse/tarball/master
 
 This installs synapse, along with the libraries it uses, into a virtual
@@ -285,6 +286,11 @@ may need to manually upgrade it::
 
     sudo pip install --upgrade pip
 
+Installing may fail with ``mock requires setuptools>=17.1. Aborting installation``.
+You can fix this by upgrading setuptools::
+
+    pip install --upgrade setuptools
+
 If pip crashes mid-installation for reason (e.g. lost terminal), pip may
 refuse to run until you remove the temporary installation directory it
 created. To reset the installation::