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

View File

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

View File

@ -32,13 +32,22 @@ Create the project database and user:
.. 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;
GRANT ALL PRIVILEGES ON DATABASE funkwhale TO funkwhale;
Assuming you already have :ref:`created your funkwhale user <create-funkwhale-user>`,
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
sudo -u funkwhale -H psql