diff options
| author | Matthew Hodgson <matthew@matrix.org> | 2014-11-17 11:11:35 -0800 |
|---|---|---|
| committer | Matthew Hodgson <matthew@matrix.org> | 2014-11-17 11:11:35 -0800 |
| commit | b57e9f58fd3ed021bc8f96a1a5659bdaffeb4670 (patch) | |
| tree | ebdd8a9ac532fc0f1834a4443060a683a088e593 /README.rst | |
| parent | Merge branch 'develop' of git+ssh://github.com/matrix-org/synapse into develop (diff) | |
| download | synapse-b57e9f58fd3ed021bc8f96a1a5659bdaffeb4670.tar.xz | |
yet another installation gotcha
Diffstat (limited to 'README.rst')
| -rw-r--r-- | README.rst | 20 |
1 files changed, 13 insertions, 7 deletions
diff --git a/README.rst b/README.rst index f77849471f..a97df1881d 100644 --- a/README.rst +++ b/README.rst @@ -145,12 +145,12 @@ To install the synapse homeserver run:: This installs synapse, along with the libraries it uses, into ``$HOME/.local/lib/``. -Troubleshooting ---------------- +Troubleshooting Installation +---------------------------- Synapse requires pip 1.7 or later, so if your OS provides too old a version and -you get errors about `error: no such option: --process-dependency-links` you may -need to manually upgrade it:: +you get errors about ``error: no such option: --process-dependency-links`` you +may need to manually upgrade it:: $ sudo pip install --upgrade pip @@ -169,10 +169,16 @@ To actually run your new homeserver, pick a working directory for Synapse to run $ cd ~/.synapse $ ~/.local/bin/synctl start -Troubleshooting ---------------- +Troubleshooting Running +----------------------- -If synapse fails with `missing "sodium.h"` crypto errors, you may need +If ``synctl`` fails with ``pkg_resources.DistributionNotFound`` errors you may +need a newer version of setuptools than that provided by your OS, and then +reinstall:: + + $ sudo pip install setuptools --upgrade + +If synapse fails with ``missing "sodium.h"`` crypto errors, you may need to manually upgrade PyNaCL, as synapse uses NaCl (http://nacl.cr.yp.to/) for encryption and digital signatures. Unfortunately PyNACL currently has a few issues |