meta data for this page
  •  

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
digital:server:matrixsynapse [2019/06/30 18:30]
natrius Step 6 - spelling errors
digital:server:matrixsynapse [2020/06/17 19:33] (current)
natrius [Step 2 - Install Synapse] - spelling error in example url
Line 63: Line 63:
     sudo systemctl enable matrix-synapse.service     sudo systemctl enable matrix-synapse.service
  
-Synapse is now up and running using the default configuration on port '​8008'​ and '​8448'​. Check the open ports using netstat command.+Synapse is now up and running using the default configuration on port '​8008'​ and '​8448'​. Check the open ports using ss (former ​netstatcommand.
  
-    ​sudo ss -plntu+    ss -plntu
  
-#### Set up well.known+#### Set up .well-known
  
 On your webserver a file at ''​%%/​.well-known/​matrix/​server%%''​ has to be set up with the following content ​ On your webserver a file at ''​%%/​.well-known/​matrix/​server%%''​ has to be set up with the following content ​
Line 77: Line 77:
 </​code>​ </​code>​
  
-Where ''/''​ is the root of your webserver. So if you navigate to ''​https://​example.com/​.well-known/​matrix.server''​ it may try to download the ''​server''​ file or show it directly+Where ''/''​ is the root of your webserver. So if you navigate to ''​https://​example.com/​.well-known/​matrix/server''​ it may try to download the ''​server''​ file or show it directly.
- +
-#### Set up SRV +
- +
-By setting an SRV record in your DNS provider, it is possible to tell other matrix servers where to connect to the server, pointing them to the correct hostname and port, in this example the default port (8448) is still used: +
- +
-<​code>​ +
-_matrix._tcp.example.com. 3600 IN SRV 10 5 443 synapse.example.com. +
-</​code>​ +
- +
-There is still an A record needed, pointing to the IP-addess of synapse on the subdomain (matrix.example.com). This way others can add your user with ''​@user:​example.com''​ instead of ''​@user:​matrix.example.com''​.+
  
 ### Step 3 - Configure Synapse ### Step 3 - Configure Synapse
Line 131: Line 121:
 Check the homeserver service with the following command Check the homeserver service with the following command
  
-    ​sudo ss -plntu+    ss -plntu
  
 You will get the Synapse service is now on the local IP address. And we have completed the Synapse installation and configuration. You will get the Synapse service is now on the local IP address. And we have completed the Synapse installation and configuration.
Line 301: Line 291:
  
   * ''​user''​ is in this case ''​synapse_user''​   * ''​user''​ is in this case ''​synapse_user''​
-  * ''​Database''​ should be the above created db, example ''​"​databse:​ synpase"​''​+  * ''​Database''​ should be the above created db, example ''​synapse''​
   * ''​Host''​ is the postgre hostname, usally ''/​var/​run/​postgresql/''​ or ''​127.0.0.1''​   * ''​Host''​ is the postgre hostname, usally ''/​var/​run/​postgresql/''​ or ''​127.0.0.1''​
  
Line 312: Line 302:
 ### Migrating from SQlite to PostgreSQL ### Migrating from SQlite to PostgreSQL
  
-There is no need for this if you have nothing done yet with synapse, otherwise, please refer to https://​github.com/​matrix-org/​synapse/​blob/​master/​docs/​postgres.rst+Assuming you already followed step 6, there is no need for a migration. If you already used your Synapse and want to migrate, please refer to https://​github.com/​matrix-org/​synapse/​blob/​master/​docs/​postgres.md
  
 ### Step 7 - Setup UFW Firewall ### Step 7 - Setup UFW Firewall
Line 336: Line 326:
 Now you need to input the user name, password, and decide whether the user will have the admin privileges or not. And we have created a new matrix user with admin privilege. Now you need to input the user name, password, and decide whether the user will have the admin privileges or not. And we have created a new matrix user with admin privilege.
  
-### Step 9 - Federation +### Step 9 - Testing
- +
-You can test if federation is working using https://​federationtester.matrix.org. If any of the checks show an error then federation won't work. Other federation-testers include: +
- +
-  * https://​fed.mau.dev/​ +
- +
-### Step 10 - Testing+
  
 If you have used Riot with the desktop application before you may not want to log out, so it is better to go to [[https://​riot.im/​app/​]] and press "​Launch now". If you have used the web client before, download the Riot desktop application,​ install it and open the Riot software. With both you will get the Matrix login page now. Type the matrix username and password, then choose the '​Custom server'​ option and type the domain name from your server ''​example.com''​ in. Click the ''​Sign In''​ button and you will get to the Riot Dashboard. If you have used Riot with the desktop application before you may not want to log out, so it is better to go to [[https://​riot.im/​app/​]] and press "​Launch now". If you have used the web client before, download the Riot desktop application,​ install it and open the Riot software. With both you will get the Matrix login page now. Type the matrix username and password, then choose the '​Custom server'​ option and type the domain name from your server ''​example.com''​ in. Click the ''​Sign In''​ button and you will get to the Riot Dashboard.
Line 350: Line 334:
 If you need two instances of riot instead, you can start it with argument, refer to [[digital:​software:​riotim|Riot.im]]. If you need two instances of riot instead, you can start it with argument, refer to [[digital:​software:​riotim|Riot.im]].
  
-For another way to test it, go to ''​https://​example.com/​_matrix/​client/​versions''​ and the output should look like the following:+For another way to test it, go to ''​https://​example.com/​_matrix/​static/''​ and you will be presented with a ''​**It works! Synapse is running**''​ screen or go to ''​https://​example.com/​_matrix/​client/​versions''​ and the output should look like the following:
  
 <code xml> <code xml>
Line 361: Line 345:
 3 "​r0.3.0"​ 3 "​r0.3.0"​
 </​code>​ </​code>​
 +
 +### Step 10 - Federation
 +
 +You can test if federation is working using https://​federationtester.matrix.org. If any of the checks show an error then federation won't work. Other federation-testers include:
 +
 +  * https://​fed.mau.dev/​
  
 ## Explanations ## Explanations