MirrorMirror
/
funkwhale
mirror of https://dev.funkwhale.audio/funkwhale/funkwhale.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Fix #185: Document that the database should use an utf-8 encoding

This commit is contained in:
Eliot Berriot 2018-04-27 18:28:44 +02:00
parent 99ff8169fc
commit a79f42b0ca
No known key found for this signature in database
GPG Key ID: DD6965E2476E5C27
2 changed files with 11 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
changes/changelog.d/185.doc Normal file
View File

@ -0,0 +1 @@
Document that the database should use an utf-8 encoding (#185)

11
docs/installation/external_dependencies.rst
View File

@ -32,13 +32,22 @@ Create the project database and user:
.. code-block:: shell .. code-block:: shell
CREATE DATABASE funkwhale; CREATE DATABASE "scratch"
WITH ENCODING 'utf8'
LC_COLLATE = 'en_US.utf8'
LC_CTYPE = 'en_US.utf8';
CREATE USER funkwhale; CREATE USER funkwhale;
GRANT ALL PRIVILEGES ON DATABASE funkwhale TO funkwhale; GRANT ALL PRIVILEGES ON DATABASE funkwhale TO funkwhale;
Assuming you already have :ref:`created your funkwhale user <create-funkwhale-user>`, Assuming you already have :ref:`created your funkwhale user <create-funkwhale-user>`,
you should now be able to open a postgresql shell: you should now be able to open a postgresql shell:
.. warning::
It's importing that you use utf-8 encoding for your database,
otherwise you'll end up with errors and crashes later on when dealing
with music metedata that contains non-ascii chars.
.. code-block:: shell .. code-block:: shell
sudo -u funkwhale -H psql sudo -u funkwhale -H psql