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:23] 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 96: | Line 103: | ||
'' | '' | ||
- | '' | + | '' |
- | #### Check listener and federation port | + | #### Check ports |
- | Now check the HTTP and HTTPS listener port ' | + | **The best is to leave it default as it comes delivered** (watch here https:// |
< | < | ||
Line 120: | 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 257: | 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 269: | 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 294: | Line 301: | ||
* '' | * '' | ||
- | * '' | + | * '' |
* '' | * '' | ||
Line 300: | Line 307: | ||
< | < | ||
- | sudo systemctl | + | sudo systemctl |
</ | </ | ||
Line 325: | 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 354: | Line 355: | ||
3 " | 3 " | ||
</ | </ | ||
+ | |||
+ | ### Step 10 - Federation | ||
+ | |||
+ | You can test if federation is working using https:// | ||
+ | |||
+ | * https:// | ||
## Explanations | ## Explanations | ||
Line 419: | Line 426: | ||
### Location of logs | ### Location of logs | ||
+ | |||
+ | Check matrix with '' | ||
+ | |||
+ | A good way to check the logs is '' | ||
+ | |||
+ | #### Matrix | ||
< | < | ||
- | / | ||
/ | / | ||
+ | </ | ||
+ | |||
+ | #### Nginx | ||
+ | |||
+ | < | ||
+ | / | ||
+ | / | ||
</ | </ | ||
Line 457: | 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 |