diff --git a/changes/changelog.d/934.doc b/changes/changelog.d/934.doc
new file mode 100644
index 0000000000000000000000000000000000000000..4b319c92214cbc20e4fedaed7be5f8b4b3f9325e
--- /dev/null
+++ b/changes/changelog.d/934.doc
@@ -0,0 +1 @@
+Documented how to create DB extension by hand in case of permission error during migrations (#934)
diff --git a/docs/admin/upgrading.rst b/docs/admin/upgrading.rst
index d18dd74475300a66201050c8f9afd59d17147c04..9f0dc37746273312912d55fccb86aeebec4a1f3b 100644
--- a/docs/admin/upgrading.rst
+++ b/docs/admin/upgrading.rst
@@ -192,6 +192,12 @@ match what is described in :doc:`/installation/debian`:
     # restart the services
     sudo systemctl start funkwhale.target
 
+.. note::
+    If you see a PermissionError when running the ``migrate`` command, try running the following commands by hand, and relaunch the migrations::
+
+        sudo -u postgres psql funkwhale -c 'CREATE EXTENSION IF NOT EXISTS "citext";'
+        sudo -u postgres psql funkwhale -c 'CREATE EXTENSION IF NOT EXISTS "unaccent";'
+
 .. warning::
 
     You may sometimes get the following warning while applying migrations::
diff --git a/docs/installation/external_dependencies.rst b/docs/installation/external_dependencies.rst
index 1e108f00a56543d497e7d8059c6f87e8b7220dc8..6925eaf729f11cc7d0561fe0f2e2ba6ff4d8e2d3 100644
--- a/docs/installation/external_dependencies.rst
+++ b/docs/installation/external_dependencies.rst
@@ -66,6 +66,7 @@ for Funkwhale to work properly:
 .. code-block:: shell
 
     sudo -u postgres psql funkwhale -c 'CREATE EXTENSION "unaccent";'
+    sudo -u postgres psql funkwhale -c 'CREATE EXTENSION "citext";'
 
 
 Cache setup (Redis)