Matrix/element-web-Github
1
0
Fork 0
mirror of https://github.com/vector-im/element-web.git synced 2024-11-15 20:54:59 +08:00
Code Issues Packages Projects Releases Wiki Activity

Document and recommend default_server_name

Browse Source 
This the recommended way to define a default server (instead of the existing HS
and IS URL options). It will use `.well-known` discovery to find the URLs.

See https://github.com/vector-im/riot-web/issues/8763.
This commit is contained in:
J. Ryan Stinnett 2019-02-19 16:17:27 +00:00
parent 5d2d8ccc71
commit 2dc26b4c5d
1 changed files with 17 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
README.md
View File

@ -116,17 +116,24 @@ config.json
You can configure the app by copying `config.sample.json` to You can configure the app by copying `config.sample.json` to
`config.json` and customising it: `config.json` and customising it:
For a good example, see https://riot.im/develop/config.json For a good example, see https://riot.im/develop/config.json.
1. `default_hs_url` is the default homeserver url. 1. `default_server_name` sets the default server name to use for authentication.
1. `default_is_url` is the default identity server url (this is the server used This will trigger Riot to ask
for verifying third party identifiers like email addresses). If this is blank, `https://<server_name>/.well-known/matrix/client` for the homeserver and
registering with an email address, adding an email address to your account, identity server URLs to use. This is the recommended approach for setting a
or inviting users via email address will not work. Matrix identity servers are default server. However, it is also possible to use the following to directly
very simple web services which map third party identifiers (currently only email configure each of the URLs:
addresses) to matrix IDs: see http://matrix.org/docs/spec/identity_service/unstable.html * `default_hs_url` sets the default homeserver URL.
for more details. Currently the only public matrix identity servers are https://matrix.org * `default_is_url` sets the default identity server URL (this is the server used
and https://vector.im. In future identity servers will be decentralised. for verifying third party identifiers like email addresses). If this is blank,
registering with an email address, adding an email address to your account,
or inviting users via email address will not work. Matrix identity servers are
very simple web services which map third party identifiers (currently only email
addresses) to matrix IDs: see http://matrix.org/docs/spec/identity_service/unstable.html
for more details. Currently the only public matrix identity servers are https://matrix.org
and https://vector.im. In the future, identity servers will be decentralised.
* Riot will report an error if you accidentally configure both `default_server_name` _and_ `default_hs_url` since it's unclear which should take priority.
1. `features`: Lookup of optional features that may be `enable`d, `disable`d, or exposed to the user 1. `features`: Lookup of optional features that may be `enable`d, `disable`d, or exposed to the user
in the `labs` section of settings. The available optional experimental features vary from in the `labs` section of settings. The available optional experimental features vary from
release to release. release to release.