summaryrefslogtreecommitdiff
path: root/docs/server.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/server.rst')
-rw-r--r--docs/server.rst23
1 files changed, 23 insertions, 0 deletions
diff --git a/docs/server.rst b/docs/server.rst
index a0eb8181..aa890ecb 100644
--- a/docs/server.rst
+++ b/docs/server.rst
@@ -43,3 +43,26 @@ twistd command. To start the soledad server, run:
An systemd script is included in the `Debian packages
<http://deb.leap.se/repository/>`_ to make it feasible to start and stop the
Soledad server service using a standard interface.
+
+Migrations
+----------
+
+Some updates of Soledad need manual intervention for database migration because
+of changes to the storage backend. In all such cases, we will document the
+steps needed for migration in this page.
+
+Soledad Server 0.8 to 0.9 - Couch Database schema migration needed
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Starting with Soledad Server 0.9.0, the CouchDB database schema was changed to
+improve speed of the server side storage backend. Because of that, this script
+has to be run for all Leap providers that used to provide email using Soledad
+Server < 0.9.0.
+
+The migration script can be found:
+
+* In `the Soledad repository <https://0xacab.org/leap/soledad/tree/master/scripts/migration/0.9>`_.
+* In ``/usr/share/soledad-server/migration/0.9/`` when the ``soledad-server`` debian package is installed.
+
+Instructions for migration can be found in the ``README.md`` file. Make sure to read it carefully and backup your data before starting the migration process.
+