From c67c41f4674407719cb59a01da98536f96fa1977 Mon Sep 17 00:00:00 2001 From: H-Shay Date: Tue, 31 Jan 2023 18:36:56 +0000 Subject: deploy: eafdb12dd8db985fbe1ac27ca75d28af8d4e4c5d --- .../usage/configuration/config_documentation.html | 35 +++++++++++++++++++--- .../configuration/homeserver_sample_config.html | 2 +- latest/usage/configuration/index.html | 2 +- .../usage/configuration/logging_sample_config.html | 9 +++--- .../configuration/user_authentication/index.html | 2 +- .../user_authentication/refresh_tokens.html | 2 +- .../user_authentication/single_sign_on/cas.html | 2 +- .../user_authentication/single_sign_on/index.html | 2 +- .../user_authentication/single_sign_on/saml.html | 2 +- 9 files changed, 43 insertions(+), 15 deletions(-) (limited to 'latest/usage/configuration') diff --git a/latest/usage/configuration/config_documentation.html b/latest/usage/configuration/config_documentation.html index 5ac7add384..f2f57562d4 100644 --- a/latest/usage/configuration/config_documentation.html +++ b/latest/usage/configuration/config_documentation.html @@ -76,7 +76,7 @@ @@ -372,7 +372,8 @@ rooms directory via federation. Defaults to false.

Known room versions are listed here

For example, for room version 1, default_room_version should be set to "1".

-

Currently defaults to "9".

+

Currently defaults to "10".

+

Changed in Synapse 1.76: the default version room version was increased from 9 to 10.

Example configuration:

default_room_version: "8"
@@ -469,6 +470,11 @@ configuration.

port: the TCP port to bind to.

  • +

    tag: An alias for the port in the logger name. If set the tag is logged instead +of the port. Default to None, is optional and only valid for listener with type: http. +See the docs request log format.

    +
    • +

  • bind_addresses: a list of local addresses to listen on. The default is 'all local interfaces'.

    • @@ -546,6 +552,13 @@ additional endpoints which should be loaded via dynamic modules.

  • static: static resources under synapse/static (/_matrix/static). (Mostly useful for 'fallback authentication'.)

    • +
  • +

    health: the health check endpoint. This endpoint +is by default active for all other resources and does not have to be activated separately. +This is only useful if you want to use the health endpoint explicitly on a dedicated port or +for workers and containers without listener e.g. +application services.

    +

    • Example configuration #1:

    listeners:
@@ -3112,8 +3125,8 @@ will also not affect rooms created by other servers.
    
 empty responses are returned to all queries. Defaults to true.
    
 
 
  • 
-
    search_all_users: Defines whether to search all users visible to your HS when searching
-the user directory. If false, search results will only contain users
+
    search_all_users: Defines whether to search all users visible to your HS at the time the search is performed. If set to true, will return all users who share a room with the user from the homeserver.
+If false, search results will only contain users
 visible in public rooms and users sharing a room with the requester.
 Defaults to false.
    
 
    NB. If you set this to true, and the last time the user_directory search
@@ -3570,6 +3583,20 @@ other workers.
    
       - names: [client, federation]
    • +

    worker_manhole

    +

    A worker may have a listener for manhole. +It allows server administrators to access a Python shell on the worker.

    +

    Example configuration:

    +
    worker_manhole: 9000
+
    +

    This is a short form for:

    +
    worker_listeners:
+  - port: 9000
+    bind_addresses: ['127.0.0.1']
+    type: manhole
+
    +

    It needs also an additional manhole_settings configuration.

    +

    worker_daemonize

    Specifies whether the worker should be started as a daemon process. If Synapse is being managed by systemd, this option diff --git a/latest/usage/configuration/homeserver_sample_config.html b/latest/usage/configuration/homeserver_sample_config.html index e48a4d48aa..ebcdf1a703 100644 --- a/latest/usage/configuration/homeserver_sample_config.html +++ b/latest/usage/configuration/homeserver_sample_config.html @@ -76,7 +76,7 @@

    diff --git a/latest/usage/configuration/index.html b/latest/usage/configuration/index.html index 52e8264c9d..1c495971ca 100644 --- a/latest/usage/configuration/index.html +++ b/latest/usage/configuration/index.html @@ -76,7 +76,7 @@ diff --git a/latest/usage/configuration/logging_sample_config.html b/latest/usage/configuration/logging_sample_config.html index c5272f82bc..1c284bb5e2 100644 --- a/latest/usage/configuration/logging_sample_config.html +++ b/latest/usage/configuration/logging_sample_config.html @@ -76,7 +76,7 @@ @@ -148,9 +148,10 @@

    Logging Sample Configuration File

    Below is a sample logging configuration file. This file can be tweaked to control how your -homeserver will output logs. A restart of the server is generally required to apply any -changes made to this file. The value of the log_config option in your homeserver -config should be the path to this file.

    +homeserver will output logs. The value of the log_config option in your homeserver config +should be the path to this file.

    +

    To apply changes made to this file, send Synapse a SIGHUP signal (or, if using systemd, run +systemctl reload on the Synapse service).

    Note that a default logging configuration (shown below) is created automatically alongside the homeserver config when following the installation instructions. It should be named <SERVERNAME>.log.config by default.

    diff --git a/latest/usage/configuration/user_authentication/index.html b/latest/usage/configuration/user_authentication/index.html index b3de5df11a..7547264240 100644 --- a/latest/usage/configuration/user_authentication/index.html +++ b/latest/usage/configuration/user_authentication/index.html @@ -76,7 +76,7 @@ diff --git a/latest/usage/configuration/user_authentication/refresh_tokens.html b/latest/usage/configuration/user_authentication/refresh_tokens.html index fc7b2c7483..f5c613a14a 100644 --- a/latest/usage/configuration/user_authentication/refresh_tokens.html +++ b/latest/usage/configuration/user_authentication/refresh_tokens.html @@ -76,7 +76,7 @@ diff --git a/latest/usage/configuration/user_authentication/single_sign_on/cas.html b/latest/usage/configuration/user_authentication/single_sign_on/cas.html index 2c1ebbba62..0a09ae308b 100644 --- a/latest/usage/configuration/user_authentication/single_sign_on/cas.html +++ b/latest/usage/configuration/user_authentication/single_sign_on/cas.html @@ -76,7 +76,7 @@ diff --git a/latest/usage/configuration/user_authentication/single_sign_on/index.html b/latest/usage/configuration/user_authentication/single_sign_on/index.html index df7ef55bc4..5e392a9f00 100644 --- a/latest/usage/configuration/user_authentication/single_sign_on/index.html +++ b/latest/usage/configuration/user_authentication/single_sign_on/index.html @@ -76,7 +76,7 @@ diff --git a/latest/usage/configuration/user_authentication/single_sign_on/saml.html b/latest/usage/configuration/user_authentication/single_sign_on/saml.html index 04b85e31ef..a37284424f 100644 --- a/latest/usage/configuration/user_authentication/single_sign_on/saml.html +++ b/latest/usage/configuration/user_authentication/single_sign_on/saml.html @@ -76,7 +76,7 @@ -- cgit 1.5.1