summary refs log tree commit diff
diff options
context:
space:
mode:
authorErik Johnston <erik@matrix.org>2021-02-16 13:27:49 +0000
committerGitHub <noreply@github.com>2021-02-16 13:27:49 +0000
commitddfdf945064925eba761ae3748e38f3a1c73c328 (patch)
tree843f1ec5924dbde670fbbde8d406d8a31cbe6c15
parentConvert additional test-cases to homeserver test case. (#9396) (diff)
downloadsynapse-ddfdf945064925eba761ae3748e38f3a1c73c328.tar.xz
Document that pusher instances are shardable (#9407)
-rw-r--r--changelog.d/9407.doc1
-rw-r--r--docs/workers.md10
2 files changed, 10 insertions, 1 deletions
diff --git a/changelog.d/9407.doc b/changelog.d/9407.doc
new file mode 100644
index 0000000000..36979bc0d8
--- /dev/null
+++ b/changelog.d/9407.doc
@@ -0,0 +1 @@
+Document that pusher instances are shardable.
diff --git a/docs/workers.md b/docs/workers.md
index f7fc6df119..9bda0f8c23 100644
--- a/docs/workers.md
+++ b/docs/workers.md
@@ -373,7 +373,15 @@ Handles sending push notifications to sygnal and email. Doesn't handle any
 REST endpoints itself, but you should set `start_pushers: False` in the
 shared configuration file to stop the main synapse sending push notifications.
 
-Note this worker cannot be load-balanced: only one instance should be active.
+To run multiple instances at once the `pusher_instances` option should list all
+pusher instances by their worker name, e.g.:
+
+```yaml
+pusher_instances:
+    - pusher_worker1
+    - pusher_worker2
+```
+
 
 ### `synapse.app.appservice`