forked from matrix-org/synapse
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'master' of gitlab.com:nova/synapse into seandon/synapse-users-query * 'master' of gitlab.com:nova/synapse: (97 commits) Changelog changes 1.19.0 More changelog tweaks More changelog tweaks Remove unwanted changelog line 1.19.0rc1 Convert the roommember database to async/await. (matrix-org#8070) Convert devices database to async/await. (matrix-org#8069) Add type hints to handlers.message and events.builder (matrix-org#8067) Convert account data, device inbox, and censor events databases to async/await (matrix-org#8063) Convert appservice, group server, profile and more databases to async (matrix-org#8066) Fix typing for notifier (matrix-org#8064) Convert tags and metrics databases to async/await (matrix-org#8062) Converts event_federation and registration databases to async/await (matrix-org#8061) Add comment explaining cast Update changelog.d/8051.misc Add typing info to Notifier (matrix-org#8058) Handle optional dependencies for Oidc and Saml Newsfile Move setting of Filter into code. ...
- Loading branch information
Showing
493 changed files
with
6,022 additions
and
4,782 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,10 +1,12 @@ | ||
| - [Choosing your server name](#choosing-your-server-name) | ||
| - [Picking a database engine](#picking-a-database-engine) | ||
| - [Installing Synapse](#installing-synapse) | ||
| - [Installing from source](#installing-from-source) | ||
| - [Platform-Specific Instructions](#platform-specific-instructions) | ||
| - [Prebuilt packages](#prebuilt-packages) | ||
| - [Setting up Synapse](#setting-up-synapse) | ||
| - [TLS certificates](#tls-certificates) | ||
| - [Client Well-Known URI](#client-well-known-uri) | ||
| - [Email](#email) | ||
| - [Registering a user](#registering-a-user) | ||
| - [Setting up a TURN server](#setting-up-a-turn-server) | ||
|
|
@@ -27,6 +29,25 @@ that your email address is probably `[email protected]` rather than | |
| `[email protected]`) - but doing so may require more advanced setup: see | ||
| [Setting up Federation](docs/federate.md). | ||
|
|
||
| # Picking a database engine | ||
|
|
||
| Synapse offers two database engines: | ||
| * [PostgreSQL](https://www.postgresql.org) | ||
| * [SQLite](https://sqlite.org/) | ||
|
|
||
| Almost all installations should opt to use PostgreSQL. Advantages include: | ||
|
|
||
| * significant performance improvements due to the superior threading and | ||
| caching model, smarter query optimiser | ||
| * allowing the DB to be run on separate hardware | ||
|
|
||
| For information on how to install and use PostgreSQL, please see | ||
| [docs/postgres.md](docs/postgres.md) | ||
|
|
||
| By default Synapse uses SQLite and in doing so trades performance for convenience. | ||
| SQLite is only recommended in Synapse for testing purposes or for servers with | ||
| light workloads. | ||
|
|
||
| # Installing Synapse | ||
|
|
||
| ## Installing from source | ||
|
|
@@ -234,17 +255,18 @@ for a number of platforms. | |
|
|
||
| There is an offical synapse image available at | ||
| https://hub.docker.com/r/matrixdotorg/synapse which can be used with | ||
| the docker-compose file available at [contrib/docker](contrib/docker). Further information on | ||
| this including configuration options is available in the README on | ||
| hub.docker.com. | ||
| the docker-compose file available at [contrib/docker](contrib/docker). Further | ||
| information on this including configuration options is available in the README | ||
| on hub.docker.com. | ||
|
|
||
| Alternatively, Andreas Peters (previously Silvio Fricke) has contributed a | ||
| Dockerfile to automate a synapse server in a single Docker image, at | ||
| https://hub.docker.com/r/avhost/docker-matrix/tags/ | ||
|
|
||
| Slavi Pantaleev has created an Ansible playbook, | ||
| which installs the offical Docker image of Matrix Synapse | ||
| along with many other Matrix-related services (Postgres database, riot-web, coturn, mxisd, SSL support, etc.). | ||
| along with many other Matrix-related services (Postgres database, Element, coturn, | ||
| ma1sd, SSL support, etc.). | ||
| For more details, see | ||
| https://github.com/spantaleev/matrix-docker-ansible-deploy | ||
|
|
||
|
|
@@ -277,22 +299,27 @@ The fingerprint of the repository signing key (as shown by `gpg | |
| /usr/share/keyrings/matrix-org-archive-keyring.gpg`) is | ||
| `AAF9AE843A7584B5A3E4CD2BCF45A512DE2DA058`. | ||
|
|
||
| #### Downstream Debian/Ubuntu packages | ||
| #### Downstream Debian packages | ||
|
|
||
| For `buster` and `sid`, Synapse is available in the Debian repositories and | ||
| it should be possible to install it with simply: | ||
| We do not recommend using the packages from the default Debian `buster` | ||
| repository at this time, as they are old and suffer from known security | ||
| vulnerabilities. You can install the latest version of Synapse from | ||
| [our repository](#matrixorg-packages) or from `buster-backports`. Please | ||
| see the [Debian documentation](https://backports.debian.org/Instructions/) | ||
| for information on how to use backports. | ||
|
|
||
| If you are using Debian `sid` or testing, Synapse is available in the default | ||
| repositories and it should be possible to install it simply with: | ||
|
|
||
| ``` | ||
| sudo apt install matrix-synapse | ||
| ``` | ||
|
|
||
| There is also a version of `matrix-synapse` in `stretch-backports`. Please see | ||
| the [Debian documentation on | ||
| backports](https://backports.debian.org/Instructions/) for information on how | ||
| to use them. | ||
| #### Downstream Ubuntu packages | ||
|
|
||
| We do not recommend using the packages in downstream Ubuntu at this time, as | ||
| they are old and suffer from known security vulnerabilities. | ||
| We do not recommend using the packages in the default Ubuntu repository | ||
| at this time, as they are old and suffer from known security vulnerabilities. | ||
| The latest version of Synapse can be installed from [our repository](#matrixorg-packages). | ||
|
|
||
| ### Fedora | ||
|
|
||
|
|
@@ -419,6 +446,60 @@ so, you will need to edit `homeserver.yaml`, as follows: | |
| For a more detailed guide to configuring your server for federation, see | ||
| [federate.md](docs/federate.md). | ||
|
|
||
| ## Client Well-Known URI | ||
|
|
||
| Setting up the client Well-Known URI is optional but if you set it up, it will | ||
| allow users to enter their full username (e.g. `@user:<server_name>`) into clients | ||
| which support well-known lookup to automatically configure the homeserver and | ||
| identity server URLs. This is useful so that users don't have to memorize or think | ||
| about the actual homeserver URL you are using. | ||
|
|
||
| The URL `https://<server_name>/.well-known/matrix/client` should return JSON in | ||
| the following format. | ||
|
|
||
| ``` | ||
| { | ||
| "m.homeserver": { | ||
| "base_url": "https://<matrix.example.com>" | ||
| } | ||
| } | ||
| ``` | ||
|
|
||
| It can optionally contain identity server information as well. | ||
|
|
||
| ``` | ||
| { | ||
| "m.homeserver": { | ||
| "base_url": "https://<matrix.example.com>" | ||
| }, | ||
| "m.identity_server": { | ||
| "base_url": "https://<identity.example.com>" | ||
| } | ||
| } | ||
| ``` | ||
|
|
||
| To work in browser based clients, the file must be served with the appropriate | ||
| Cross-Origin Resource Sharing (CORS) headers. A recommended value would be | ||
| `Access-Control-Allow-Origin: *` which would allow all browser based clients to | ||
| view it. | ||
|
|
||
| In nginx this would be something like: | ||
| ``` | ||
| location /.well-known/matrix/client { | ||
| return 200 '{"m.homeserver": {"base_url": "https://<matrix.example.com>"}}'; | ||
| add_header Content-Type application/json; | ||
| add_header Access-Control-Allow-Origin *; | ||
| } | ||
| ``` | ||
|
|
||
| You should also ensure the `public_baseurl` option in `homeserver.yaml` is set | ||
| correctly. `public_baseurl` should be set to the URL that clients will use to | ||
| connect to your server. This is the same URL you put for the `m.homeserver` | ||
| `base_url` above. | ||
|
|
||
| ``` | ||
| public_baseurl: "https://<matrix.example.com>" | ||
| ``` | ||
|
|
||
|
|
||
|
|
@@ -437,7 +518,7 @@ email will be disabled. | |
|
|
||
| ## Registering a user | ||
|
|
||
| The easiest way to create a new user is to do so from a client like [Riot](https://riot.im). | ||
| The easiest way to create a new user is to do so from a client like [Element](https://element.io/). | ||
|
|
||
| Alternatively you can do so from the command line if you have installed via pip. | ||
|
|
||
|
|
||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.