summary refs log tree commit diff
path: root/docs/workers.md
diff options
context:
space:
mode:
authorBrendan Abolivier <babolivier@matrix.org>2020-01-27 12:30:54 +0000
committerGitHub <noreply@github.com>2020-01-27 12:30:54 +0000
commitf74d178b1778aa8981898806cd94b4512c61c7fb (patch)
treea887a8137dcca533619925e9df95dc0cb305dada /docs/workers.md
parentValidate client_secret parameter (#6767) (diff)
parentFormatting of changelog (diff)
downloadsynapse-f74d178b1778aa8981898806cd94b4512c61c7fb.tar.xz
Merge pull request #6775 from matrix-org/jaywink/worker-docs-tweaks
Clarifications to the workers documentation
Diffstat (limited to 'docs/workers.md')
-rw-r--r--docs/workers.md17
1 files changed, 17 insertions, 0 deletions
diff --git a/docs/workers.md b/docs/workers.md
index 0ab269fd96..09a9d8a7b8 100644
--- a/docs/workers.md
+++ b/docs/workers.md
@@ -185,6 +185,19 @@ reverse-proxy configuration.
 The `^/_matrix/federation/v1/send/` endpoint must only be handled by a single
 instance.
 
+Note that `federation` must be added to the listener resources in the worker config:
+
+```yaml
+worker_app: synapse.app.federation_reader
+...
+worker_listeners:
+ - type: http
+   port: <port>
+   resources:
+     - names:
+       - federation
+```
+
 ### `synapse.app.federation_sender`
 
 Handles sending federation traffic to other servers. Doesn't handle any
@@ -265,6 +278,10 @@ the following regular expressions:
 
     ^/_matrix/client/(api/v1|r0|unstable)/user_directory/search$
 
+When using this worker you must also set `update_user_directory: False` in the 
+shared configuration file to stop the main synapse running background 
+jobs related to updating the user directory.
+
 ### `synapse.app.frontend_proxy`
 
 Proxies some frequently-requested client endpoints to add caching and remove