diff --git a/UPGRADING b/UPGRADING
index f18bf760..3c05ec4d 100644
--- a/UPGRADING
+++ b/UPGRADING
@@ -11,6 +11,23 @@ usually prudent:
   `composer install -o --no-dev`
 
 
+Upgrading from 0.8.5 to 0.9.0
+=============================
+
+- The database schema has changed from rev6 to rev7; if upgrading the database
+  manually, apply the 6.sql file
+- Web server configuration has changed to accommodate Miniflux; the following
+  URL paths are affected:
+    - /v1/
+    - /version
+    - /healthcheck
+- Icons for existing feeds in Miniflux and Fever will only appear once the
+  feeds in question have been fetched after upgrade. This may take up to
+  twenty-four hours to occur
+- An administrator account is now required to refresh feeds via the 
+  Nextcloud News protocol
+
+
 Upgrading from 0.8.4 to 0.8.5
 =============================