summary refs log tree commit diff
path: root/docs/usage
diff options
context:
space:
mode:
authorShay <hillerys@element.io>2022-08-15 11:54:23 -0700
committerGitHub <noreply@github.com>2022-08-15 11:54:23 -0700
commit73c83c641138f0644582468a869e10f19f389800 (patch)
tree33d48f49947dd05f8fd40c4149647c031d6193d2 /docs/usage
parentInstrument `FederationStateIdsServlet` - `/state_ids` (#13499) (diff)
downloadsynapse-73c83c641138f0644582468a869e10f19f389800.tar.xz
Add a warning to retention documentation regarding the possibility of database corruption (#13497)
Diffstat (limited to 'docs/usage')
-rw-r--r--docs/usage/configuration/config_documentation.md6
1 files changed, 5 insertions, 1 deletions
diff --git a/docs/usage/configuration/config_documentation.md b/docs/usage/configuration/config_documentation.md
index bc3d2bec6a..d8c29e6063 100644
--- a/docs/usage/configuration/config_documentation.md
+++ b/docs/usage/configuration/config_documentation.md
@@ -849,7 +849,11 @@ which are older than the room's maximum retention period. Synapse will also
 filter events received over federation so that events that should have been
 purged are ignored and not stored again.
 
-The message retention policies feature is disabled by default.
+The message retention policies feature is disabled by default. Please be advised 
+that enabling this feature carries some risk. There are known bugs with the implementation
+which can cause database corruption. Setting retention to delete older history
+is less risky than deleting newer history but in general caution is advised when enabling this
+experimental feature. You can read more about this feature [here](../../message_retention_policies.md).
 
 This setting has the following sub-options:
 * `default_policy`: Default retention policy. If set, Synapse will apply it to rooms that lack the