···

       
18
       
 
       


     

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

     

       
20
       
 
       
the reference homeserver implementation of Matrix from the core development

     

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

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

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

     

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

     

       
24
       
 
       
please refer to the

     
···

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

     

       
42
       
 
       


     

       
43
       
 
       
  services.postgresql.enable = true;

     

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

     

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

     

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

     

       
47
       
-
       
      TEMPLATE template0

     

       
48
       
-
       
      LC_COLLATE = "C"

     

       
49
       
-
       
      LC_CTYPE = "C";

     

       
50
       
-
       
  '';

     

       
51
       
 
       


     

       
52
       
 
       
  services.nginx = {

     

       
53
       
 
       
    enable = true;

     

···

       
18
       
 
       


     

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

     

       
20
       
 
       
the reference homeserver implementation of Matrix from the core development

     

       
21
       
+
       
team at matrix.org.

     

       
22
       
+
       


     

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

     

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

     

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

     

       
26
       
+
       
executed before synapse starts up:

     

       
27
       
+
       


     

       
28
       
+
       
```sql

     

       
29
       
+
       
CREATE ROLE "matrix-synapse";

     

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

     

       
31
       
+
       
  TEMPLATE template0

     

       
32
       
+
       
  LC_COLLATE = "C"

     

       
33
       
+
       
  LC_CTYPE = "C";

     

       
34
       
+
       
```

     

       
35
       
+
       


     

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

     

       
37
       
+
       
continuing with the installation.

     

       
38
       
+
       


     

       
39
       
+
       
Please make sure to set a different password.

     

       
40
       
+
       


     

       
41
       
+
       
The following configuration example will set up a

     

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

     

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

     

       
44
       
 
       
please refer to the

     
···

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

     

       
62
       
 
       


     

       
63
       
 
       
  services.postgresql.enable = true;

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
64
       
 
       


     

       
65
       
 
       
  services.nginx = {

     

       
66
       
 
       
    enable = true;