summary refs log tree commit diff
diff options
context:
space:
mode:
authorBrendan Abolivier <babolivier@matrix.org>2022-03-25 10:56:18 +0100
committerGitHub <noreply@github.com>2022-03-25 10:56:18 +0100
commit5859e2fe0cd23228192de7c40b8b1c760efa77d2 (patch)
treedb8efdc5a7a0550ef498d2b8e556b596fab7103f
parentRe-enable test concurrency on Complement (#12283) (diff)
downloadsynapse-5859e2fe0cd23228192de7c40b8b1c760efa77d2.tar.xz
Mention the new behaviour on unsafe database locale in the upgrade notes (#12288)
Co-authored-by: Shay <hillerys@element.io>
-rw-r--r--changelog.d/12288.misc1
-rw-r--r--docs/upgrade.md7
2 files changed, 8 insertions, 0 deletions
diff --git a/changelog.d/12288.misc b/changelog.d/12288.misc
new file mode 100644
index 0000000000..ee8fbfd290
--- /dev/null
+++ b/changelog.d/12288.misc
@@ -0,0 +1 @@
+Refuse to start if DB has non-`C` locale, unless config flag `allow_unsafe_db_locale` is set to true.
diff --git a/docs/upgrade.md b/docs/upgrade.md
index f9ac605e7b..f039710520 100644
--- a/docs/upgrade.md
+++ b/docs/upgrade.md
@@ -99,6 +99,13 @@ experimental_features:
   groups_enabled: false
 ```
 
+## Change in behaviour for PostgreSQL databases with unsafe locale
+
+Synapse now refuses to start when using PostgreSQL with non-`C` values for `COLLATE` and
+`CTYPE` unless the config flag `allow_unsafe_locale`, found in the database section of
+the configuration file, is set to `true`. See the [PostgreSQL documentation](https://matrix-org.github.io/synapse/latest/postgres.html#fixing-incorrect-collate-or-ctype)
+for more information and instructions on how to fix a database with incorrect values.
+
 # Upgrading to v1.55.0
 
 ## `synctl` script has been moved