summary refs log tree commit diff
diff options
context:
space:
mode:
authorvillepeh <100730729+villepeh@users.noreply.github.com>2023-12-04 14:38:46 +0200
committerGitHub <noreply@github.com>2023-12-04 12:38:46 +0000
commit0aa4d3b6f7193d9721bd484dae0242ccd0cc10b8 (patch)
tree944f526baa1db07a82234704c802417ea56bcf6c
parentBump phonenumbers from 8.13.23 to 8.13.26 (#16722) (diff)
downloadsynapse-0aa4d3b6f7193d9721bd484dae0242ccd0cc10b8.tar.xz
Switch UNIX socket paths to /run, and add a UNIX socket example for HAProxy (#16700)
-rw-r--r--changelog.d/16700.doc1
-rw-r--r--docs/reverse_proxy.md6
-rw-r--r--docs/usage/configuration/config_documentation.md14
3 files changed, 13 insertions, 8 deletions
diff --git a/changelog.d/16700.doc b/changelog.d/16700.doc
new file mode 100644
index 0000000000..0d55ad338a
--- /dev/null
+++ b/changelog.d/16700.doc
@@ -0,0 +1 @@
+Switch the example UNIX socket paths to /run. Add HAProxy example configuration for UNIX sockets.
diff --git a/docs/reverse_proxy.md b/docs/reverse_proxy.md
index fe9519b4b6..20854035d1 100644
--- a/docs/reverse_proxy.md
+++ b/docs/reverse_proxy.md
@@ -181,7 +181,11 @@ frontend matrix-federation
 backend matrix
   server matrix 127.0.0.1:8008
 ```
-
+Example configuration, if using a UNIX socket. The configuration lines regarding the frontends do not need to be modified.
+```
+backend matrix
+  server matrix unix@/run/synapse/main_public.sock
+```
 
 [Delegation](delegate.md) example:
 ```
diff --git a/docs/usage/configuration/config_documentation.md b/docs/usage/configuration/config_documentation.md
index 812a7d429b..e6fcffb570 100644
--- a/docs/usage/configuration/config_documentation.md
+++ b/docs/usage/configuration/config_documentation.md
@@ -566,7 +566,7 @@ listeners:
   # Note that x_forwarded will default to true, when using a UNIX socket. Please see
   # https://matrix-org.github.io/synapse/latest/reverse_proxy.html.
   #
-  - path: /var/run/synapse/main_public.sock
+  - path: /run/synapse/main_public.sock
     type: http
     resources:
       - names: [client, federation]
@@ -4218,9 +4218,9 @@ Example configuration(#2, for UNIX sockets):
 ```yaml
 instance_map:
   main:
-    path: /var/run/synapse/main_replication.sock
+    path: /run/synapse/main_replication.sock
   worker1:
-    path: /var/run/synapse/worker1_replication.sock
+    path: /run/synapse/worker1_replication.sock
 ```
 ---
 ### `stream_writers`
@@ -4406,13 +4406,13 @@ Example configuration(#2, using UNIX sockets with a `replication` listener):
 ```yaml
 worker_listeners:
   - type: http
-    path: /var/run/synapse/worker_public.sock
+    path: /run/synapse/worker_replication.sock
     resources:
-      - names: [client, federation]
+      - names: [replication]
   - type: http
-    path: /var/run/synapse/worker_replication.sock
+    path: /run/synapse/worker_public.sock
     resources:
-      - names: [replication]
+      - names: [client, federation]
 ```
 ---
 ### `worker_manhole`