Improved docs on setting up Postgresql (#5661)

Added that synapse_user needs a database to access before it can auth
Noted you'll need to enable password auth, linked to pg_hba.conf docs
This commit is contained in:
Lrizika 2019-07-11 06:31:36 -07:00 committed by Richard van der Hoff
parent 78a1cd36b5
commit 39e9839a04
2 changed files with 16 additions and 4 deletions

1
changelog.d/5661.docs Normal file
View file

@ -0,0 +1 @@
Improvements to Postgres setup instructions. Contributed by @Lrizika - thanks!

View file

@ -34,9 +34,14 @@ Assuming your PostgreSQL database user is called ``postgres``, create a user
su - postgres su - postgres
createuser --pwprompt synapse_user createuser --pwprompt synapse_user
The PostgreSQL database used *must* have the correct encoding set, otherwise it Before you can authenticate with the ``synapse_user``, you must create a
would not be able to store UTF8 strings. To create a database with the correct database that it can access. To create a database, first connect to the database
encoding use, e.g.:: with your database user::
su - postgres
psql
and then run::
CREATE DATABASE synapse CREATE DATABASE synapse
ENCODING 'UTF8' ENCODING 'UTF8'
@ -46,7 +51,13 @@ encoding use, e.g.::
OWNER synapse_user; OWNER synapse_user;
This would create an appropriate database named ``synapse`` owned by the This would create an appropriate database named ``synapse`` owned by the
``synapse_user`` user (which must already exist). ``synapse_user`` user (which must already have been created as above).
Note that the PostgreSQL database *must* have the correct encoding set (as
shown above), otherwise it will not be able to store UTF8 strings.
You may need to enable password authentication so ``synapse_user`` can connect
to the database. See https://www.postgresql.org/docs/11/auth-pg-hba-conf.html.
Tuning Postgres Tuning Postgres
=============== ===============