summary refs log tree commit diff
path: root/UPGRADE.rst
diff options
context:
space:
mode:
authorDan Callahan <danc@element.io>2021-01-12 20:11:15 +0000
committerGitHub <noreply@github.com>2021-01-12 20:11:15 +0000
commit6d91e6ca5f75720b5d594fc960b1208ddd50e148 (patch)
tree1b1291365a206f147b55f6fd4f771737dcbc9441 /UPGRADE.rst
parentDon't apply the IP range blacklist to proxy connections (#9084) (diff)
downloadsynapse-6d91e6ca5f75720b5d594fc960b1208ddd50e148.tar.xz
Announce Python / PostgreSQL deprecation policies (#9085)
Fixes #8782
Diffstat (limited to 'UPGRADE.rst')
-rw-r--r--UPGRADE.rst22
1 files changed, 22 insertions, 0 deletions
diff --git a/UPGRADE.rst b/UPGRADE.rst
index 54a40bd42f..f750d17da2 100644
--- a/UPGRADE.rst
+++ b/UPGRADE.rst
@@ -5,6 +5,16 @@ Before upgrading check if any special steps are required to upgrade from the
 version you currently have installed to the current version of Synapse. The extra
 instructions that may be required are listed later in this document.
 
+* Check that your versions of Python and PostgreSQL are still supported.
+
+  Synapse follows upstream lifecycles for `Python`_ and `PostgreSQL`_, and
+  removes support for versions which are no longer maintained.
+
+  The website https://endoflife.date also offers convenient summaries.
+
+  .. _Python: https://devguide.python.org/devcycle/#end-of-life-branches
+  .. _PostgreSQL: https://www.postgresql.org/support/versioning/
+
 * If Synapse was installed using `prebuilt packages
   <INSTALL.md#prebuilt-packages>`_, you will need to follow the normal process
   for upgrading those packages.
@@ -78,6 +88,18 @@ for example:
 Upgrading to v1.25.0
 ====================
 
+Last release supporting Python 3.5
+----------------------------------
+
+This is the last release of Synapse which guarantees support with Python 3.5,
+which passed its upstream End of Life date several months ago.
+
+We will attempt to maintain support through March 2021, but without guarantees.
+
+In the future, Synapse will follow upstream schedules for ending support of
+older versions of Python and PostgreSQL. Please upgrade to at least Python 3.6
+and PostgreSQL 9.6 as soon as possible.
+
 Blacklisting IP ranges
 ----------------------