summary refs log tree commit diff
path: root/UPGRADE.rst
diff options
context:
space:
mode:
authorErik Johnston <erik@matrix.org>2015-08-20 16:09:27 +0100
committerErik Johnston <erik@matrix.org>2015-08-20 16:09:27 +0100
commit3befc9ccc3b7d19fc7c19af3ee9572d89e0fe127 (patch)
tree1949a627914b7f22f4450fc76d133db49e278b3b /UPGRADE.rst
parentMerge pull request #235 from matrix-org/erikj/room_avatars (diff)
parentMerge pull request #237 from matrix-org/markjh/readme-rst-formatting (diff)
downloadsynapse-3befc9ccc3b7d19fc7c19af3ee9572d89e0fe127.tar.xz
Merge branch 'release-v0.10.0' of github.com:matrix-org/synapse into develop
Diffstat (limited to 'UPGRADE.rst')
-rw-r--r--UPGRADE.rst33
1 files changed, 33 insertions, 0 deletions
diff --git a/UPGRADE.rst b/UPGRADE.rst
index d98460f643..35a0333a7e 100644
--- a/UPGRADE.rst
+++ b/UPGRADE.rst
@@ -1,3 +1,36 @@
+Upgrading Synapse
+=================
+
+Before upgrading check if any special steps are required to upgrade from the
+what you currently have installed to current version of synapse. The extra
+instructions that may be required are listed later in this document.
+
+If synapse was installed in a virtualenv then active that virtualenv before
+upgrading. If synapse is installed in a virtualenv in ``~/.synapse/`` then run:
+
+.. code:: bash
+
+    source ~/.synapse/bin/activate
+
+If synapse was installed using pip then upgrade to the latest version by
+running:
+
+.. code:: bash
+
+    pip install --upgrade --process-dependency-links https://github.com/matrix-org/synapse/tarball/master
+
+If synapse was installed using git then upgrade to the latest version by
+running:
+
+.. code:: bash
+
+    # Pull the latest version of the master branch.
+    git pull
+    # Update the versions of synapse's python dependencies.
+    python synapse/python_dependencies.py | xargs -n1 pip install
+
+
+
 Upgrading to v0.9.0
 ===================