summary refs log tree commit diff
diff options
context:
space:
mode:
authorDavid Robertson <davidr@element.io>2022-09-08 12:00:03 +0100
committerGitHub <noreply@github.com>2022-09-08 12:00:03 +0100
commita7c71686ca6c6b8e2dd3ba005669a4707e56869f (patch)
treea1a665c6b50910858d6db7e3c44942366fd78429
parentFixup changelog (diff)
downloadsynapse-a7c71686ca6c6b8e2dd3ba005669a4707e56869f.tar.xz
Add minimum version bump for sqlite to the release notes (#13742)
* Notify that SQLite min version will be bumped
* Mention in upgrade notes

Co-authored-by: reivilibre <oliverw@matrix.org>
-rw-r--r--CHANGES.md7
-rw-r--r--docs/upgrade.md15
2 files changed, 21 insertions, 1 deletions
diff --git a/CHANGES.md b/CHANGES.md
index ad277f32e5..c2c628d1a5 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -8,11 +8,16 @@ notes](https://matrix-org.github.io/synapse/v1.67/upgrade.html#upgrading-to-v167
 The minimum version of `poetry` supported for managing source checkouts is now
 1.2.0.
 
-Notice: from the next major release (v1.68.0) installing Synapse from a source
+**Notice:** from the next major release (v1.68.0) installing Synapse from a source
 checkout will require a recent Rust compiler. Those using packages or
 `pip install matrix-synapse` will not be affected. See the [upgrade
 notes](https://matrix-org.github.io/synapse/v1.67/upgrade.html#upgrading-to-v1670).
 
+**Notice:** from the next major release (v1.68.0), running Synapse with a SQLite
+database will require SQLite version 3.27.0 or higher. (The [current minimum
+ version is SQLite 3.22.0](https://github.com/matrix-org/synapse/blob/release-v1.67/synapse/storage/engines/sqlite.py#L69-L78).)
+See [#12983](https://github.com/matrix-org/synapse/issues/12983) for more details.
+
 
 Features
 --------
diff --git a/docs/upgrade.md b/docs/upgrade.md
index 023ca0a30b..9f165551fa 100644
--- a/docs/upgrade.md
+++ b/docs/upgrade.md
@@ -119,6 +119,21 @@ will require a recent Rust compiler. Those using packages or
 
 The simplest way of installing Rust is via [rustup.rs](https://rustup.rs/)
 
+## SQLite version requirement in the next release
+
+From the next major release (v1.68.0) Synapse will require SQLite 3.27.0 or 
+higher. Synapse v1.67.0 will be the last major release supporting SQLite
+versions 3.22 to 3.26.
+
+Those using docker images or Debian packages from Matrix.org will not be
+affected. If you have installed from source, you should check the version of 
+SQLite used by Python with:
+
+```shell
+python -c "import sqlite3; print(sqlite3.sqlite_version)"
+```
+
+If this is too old, refer to your distribution for advice on upgrading.
 
 # Upgrading to v1.66.0