From c67c41f4674407719cb59a01da98536f96fa1977 Mon Sep 17 00:00:00 2001
From: H-Shay
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'.
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 -- cgit 1.5.1