diff --git a/docs/simplesamlphp-upgrade-notes-2.1.md b/docs/simplesamlphp-upgrade-notes-2.1.md
new file mode 100644
index 0000000000000000000000000000000000000000..77fc0149c4d030dc4497c951ceacce023d6bdc52
--- /dev/null
+++ b/docs/simplesamlphp-upgrade-notes-2.1.md
@@ -0,0 +1,16 @@
+# Upgrade notes for SimpleSAMLphp 2.1
+
+SimpleSAMLphp 2.1 is a minor new release which bumps some
+of the minimum requirements to be able to run SimpleSAMLphp.
+The following changes are relevant for installers and/or developers.
+
+## Software requirements
+
+- The minimum PHP version required is now PHP 8.0.
+- Dropped support for Symfony 5.4.
+
+## Two builds
+
+As of SimpleSAMLphp 2.1 two builds are created for every release.
+The 'slim' build is a lightweight build without any modules other than the core modules installed (alike the 2.0 build).
+A new 'full' build is added that will come with the most used modules pre-installed.
diff --git a/docs/simplesamlphp-upgrade-notes.md b/docs/simplesamlphp-upgrade-notes.md
index 8b0756b4b89d6ea51f4d0c0c6ad0aa895aeb74df..1ec56e70df4cea07dbb64fdcf2ededd59561cb3c 100644
--- a/docs/simplesamlphp-upgrade-notes.md
+++ b/docs/simplesamlphp-upgrade-notes.md
@@ -3,6 +3,7 @@
 See the following pages for important information for users upgrading
 from older versions of SimpleSAMLphp:
 
+* [Upgrade notes for version 2.1](simplesamlphp-upgrade-notes-2.1)
 * [Upgrade notes for version 2.0](simplesamlphp-upgrade-notes-2.0)
 * [Upgrade notes for version 1.19](simplesamlphp-upgrade-notes-1.19)
 * [Upgrade notes for version 1.18](simplesamlphp-upgrade-notes-1.18)