commit a3d3cdf5d9fcfc086f7f83c4e9a4833f0e24e111 · pyrox.dev/nixpkgs

+21 -8
nixos/modules/services/matrix/synapse.md
···

       18
       18
        
       

     

       19
       19
        
       [Synapse](https://github.com/element-hq/synapse) is

     

       20
       20
        
       the reference homeserver implementation of Matrix from the core development

     

       21
       21
       -
       team at matrix.org. The following configuration example will set up a

     

       21
       21
       +
       team at matrix.org.

     

       22
       22
       +
       

     

       23
       23
       +
       Before deploying synapse server, a postgresql database must be set up.

     

       24
       24
       +
       For that, please make sure that postgresql is running and the following

     

       25
       25
       +
       SQL statements to create a user & database called `matrix-synapse` were

     

       26
       26
       +
       executed before synapse starts up:

     

       27
       27
       +
       

     

       28
       28
       +
       ```sql

     

       29
       29
       +
       CREATE ROLE "matrix-synapse";

     

       30
       30
       +
       CREATE DATABASE "matrix-synapse" WITH OWNER "matrix-synapse"

     

       31
       31
       +
         TEMPLATE template0

     

       32
       32
       +
         LC_COLLATE = "C"

     

       33
       33
       +
         LC_CTYPE = "C";

     

       34
       34
       +
       ```

     

       35
       35
       +
       

     

       36
       36
       +
       Usually, it's sufficient to do this once manually before

     

       37
       37
       +
       continuing with the installation.

     

       38
       38
       +
       

     

       39
       39
       +
       Please make sure to set a different password.

     

       40
       40
       +
       

     

       41
       41
       +
       The following configuration example will set up a

     

       22
       42
        
       synapse server for the `example.org` domain, served from

     

       23
       43
        
       the host `myhostname.example.org`. For more information,

     

       24
       44
        
       please refer to the

     
···

       41
       61
        
         networking.firewall.allowedTCPPorts = [ 80 443 ];

     

       42
       62
        
       

     

       43
       63
        
         services.postgresql.enable = true;

     

       44
       44
       -
         services.postgresql.initialScript = pkgs.writeText "synapse-init.sql" ''

     

       45
       45
       -
           CREATE ROLE "matrix-synapse" WITH LOGIN PASSWORD 'synapse';

     

       46
       46
       -
           CREATE DATABASE "matrix-synapse" WITH OWNER "matrix-synapse"

     

       47
       47
       -
             TEMPLATE template0

     

       48
       48
       -
             LC_COLLATE = "C"

     

       49
       49
       -
             LC_CTYPE = "C";

     

       50
       50
       -
         '';

     

       51
       64
        
       

     

       52
       65
        
         services.nginx = {

     

       53
       66
        
           enable = true;