From 49f8fba232c2c4d7efb050b8e0f499015d25a344 Mon Sep 17 00:00:00 2001
From: Eliot Berriot <contact@eliotberriot.com>
Date: Tue, 15 Oct 2019 11:52:15 +0200
Subject: [PATCH] Fix #934: Documented how to create DB extension by hand in
case of permission error during migrations
---
changes/changelog.d/934.doc | 1 +
docs/admin/upgrading.rst | 6 ++++++
docs/installation/external_dependencies.rst | 1 +
3 files changed, 8 insertions(+)
create mode 100644 changes/changelog.d/934.doc
diff --git a/changes/changelog.d/934.doc b/changes/changelog.d/934.doc
new file mode 100644
index 000000000..4b319c922
--- /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 d18dd7447..9f0dc3774 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 1e108f00a..6925eaf72 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)
--
GitLab