Note that Synapse 1.74 queued a user dir rebuild (matrix-org#15386)

* Note that Synapse 1.74 queued a user dir rebuild * Changelog
realtyem · Apr 12, 2023 · c5f5032 · c5f5032
1 parent 2c25f5d
commit c5f5032
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 0 deletions.
diff --git a/changelog.d/15386.doc b/changelog.d/15386.doc
@@ -0,0 +1 @@
+Note that Synapse 1.74 queued a rebuild of the user directory tables.
diff --git a/docs/upgrade.md b/docs/upgrade.md
@@ -199,6 +199,17 @@ Docker images and Debian packages need nothing specific as they already
 include or specify ICU as an explicit dependency.
 
 
+## User directory rebuild
+
+Synapse 1.74 queues a background update
+[to rebuild the user directory](https://github.com/matrix-org/synapse/pull/14643),
+in order to fix missing or erroneous entries.
+
+When this update begins, the user directory will be cleared out and rebuilt from
+scratch. User directory lookups will be incomplete until the rebuild completes.
+Admins can monitor the rebuild's progress by using the
+[Background update Admin API](usage/administration/admin_api/background_updates.md#status).
+
 # Upgrading to v1.73.0
 
 ## Legacy Prometheus metric names have now been removed