mirror of
https://github.com/element-hq/synapse.git
synced 2024-11-22 09:35:45 +03:00
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:
parent
78a1cd36b5
commit
39e9839a04
2 changed files with 16 additions and 4 deletions
1
changelog.d/5661.docs
Normal file
1
changelog.d/5661.docs
Normal file
|
@ -0,0 +1 @@
|
||||||
|
Improvements to Postgres setup instructions. Contributed by @Lrizika - thanks!
|
|
@ -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
|
||||||
===============
|
===============
|
||||||
|
|
Loading…
Reference in a new issue