meta data for this page
Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
digital:server:matrixsynapse [2019/05/30 11:09] natrius [Step 2 - Install Synapse] |
digital:server:matrixsynapse [2019/06/30 18:31] natrius Switched Step 9 and 10 |
||
---|---|---|---|
Line 39: | Line 39: | ||
sudo apt install -y lsb-release wget apt-transport-https | sudo apt install -y lsb-release wget apt-transport-https | ||
sudo wget -O / | sudo wget -O / | ||
- | echo "deb [signed-by=/ | + | echo "deb [signed-by=/ |
- | | + | |
</ | </ | ||
Line 70: | Line 69: | ||
#### Set up well.known | #### Set up well.known | ||
- | FIXME | + | On your webserver a file at '' |
+ | |||
+ | < | ||
+ | { | ||
+ | " | ||
+ | } | ||
+ | </ | ||
+ | |||
+ | Where ''/'' | ||
#### Set up SRV | #### Set up SRV | ||
Line 77: | Line 84: | ||
< | < | ||
- | _matrix._tcp.example.com. 3600 IN SRV 10 5 443 synapse.example.com. | + | _matrix._tcp.example.com. 3600 IN SRV 10 5 443 synapse.example.com. |
</ | </ | ||
Line 96: | Line 103: | ||
'' | '' | ||
- | '' | + | '' |
- | + | ||
- | #### Check listener and federation port | + | |
- | Now check the HTTP and HTTPS listener port ' | + | #### Check ports |
- | FIXME What about the TLS-part of the config? By default it is disbaled, so what to do to enable | + | **The best is to leave it default |
< | < | ||
Line 122: | Line 127: | ||
Now restart the Synapse services. | Now restart the Synapse services. | ||
- | sudo systemctl | + | sudo systemctl |
Check the homeserver service with the following command | Check the homeserver service with the following command | ||
Line 183: | Line 188: | ||
< | < | ||
- | |||
- | FIXME We need infos here how and where to edit the homeserver.yaml to add our certificates. | ||
### Step 5 - Install and configure Nginx as a reverse proxy | ### Step 5 - Install and configure Nginx as a reverse proxy | ||
Line 261: | Line 264: | ||
Nginx installation and configuration as a reverse proxy for the Synapse homeserver has been completed. | Nginx installation and configuration as a reverse proxy for the Synapse homeserver has been completed. | ||
- | ### (Optional) Step 6 - Postgre | + | ### (Optional) Step 6 - PostgreSQL |
While the step is marked as optional, it is **strongly encouraged** for any server that isn't purely for testing. | While the step is marked as optional, it is **strongly encouraged** for any server that isn't purely for testing. | ||
- | #### Initial | + | #### Initial |
< | < | ||
Line 273: | Line 276: | ||
< | < | ||
- | Where username can be " | + | Where username can be '' |
To end the postgre line just type in '' | To end the postgre line just type in '' | ||
- | #### Set up Postgre | + | #### Set up PostgreSQL |
< | < | ||
Line 298: | Line 301: | ||
* '' | * '' | ||
- | * '' | + | * '' |
* '' | * '' | ||
Line 304: | Line 307: | ||
< | < | ||
- | sudo systemctl | + | sudo systemctl |
</ | </ | ||
Line 329: | Line 332: | ||
At this stage, the Synapse homeserver installation and configuration is complete. And in this step, we need to add a new matrix user from the command line on the server. To create a new matrix user, run the command below. | At this stage, the Synapse homeserver installation and configuration is complete. And in this step, we need to add a new matrix user from the command line on the server. To create a new matrix user, run the command below. | ||
- | register_new_matrix_user -c homeserver.yaml http:// | + | register_new_matrix_user -c / |
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:// | + | |
- | + | ||
- | * https:// | + | |
- | + | ||
- | ### 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:// | 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:// | ||
Line 358: | Line 355: | ||
3 " | 3 " | ||
</ | </ | ||
+ | |||
+ | ### Step 10 - Federation | ||
+ | |||
+ | You can test if federation is working using https:// | ||
+ | |||
+ | * https:// | ||
## Explanations | ## Explanations | ||
Line 423: | Line 426: | ||
### Location of logs | ### Location of logs | ||
+ | |||
+ | Check matrix with '' | ||
+ | |||
+ | A good way to check the logs is '' | ||
+ | |||
+ | #### Matrix | ||
< | < | ||
- | / | ||
/ | / | ||
+ | </ | ||
+ | |||
+ | #### Nginx | ||
+ | |||
+ | < | ||
+ | / | ||
+ | / | ||
</ | </ | ||
Line 461: | Line 476: | ||
For feedback about this guide or tips on how to improve it visit https:// | For feedback about this guide or tips on how to improve it visit https:// | ||
- | ### ToDo | ||
- | |||
- | * More explanations (explain more, because open source documentation is famously sparse) | ||
- | * what nginx | ||
- | * reverse proxy | ||
- | * what is postgre and why is it preferred over sqlite |