summary refs log tree commit diff
path: root/docs
diff options
context:
space:
mode:
authorRyan Cole <admin@ryanc.me>2020-08-19 23:26:50 +1200
committerGitHub <noreply@github.com>2020-08-19 12:26:50 +0100
commitcfeb37f039bff557d47247b21a3080a930e60d90 (patch)
tree919e34d483bbe4ae8841e0c26ac7f6c7b594132f /docs
parentBe stricter about JSON that is accepted by Synapse (#8106) (diff)
downloadsynapse-cfeb37f039bff557d47247b21a3080a930e60d90.tar.xz
Updated docs: Added note about missing 308 redirect support. (#8120)
* Updated docs: Added note about missing 308 redirect support.

* Added changelog
Diffstat (limited to '')
-rw-r--r--docs/federate.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/federate.md b/docs/federate.md
index a0786b9cf7..b15cd724d1 100644
--- a/docs/federate.md
+++ b/docs/federate.md
@@ -47,6 +47,18 @@ you invite them to. This can be caused by an incorrectly-configured reverse
 proxy: see [reverse_proxy.md](<reverse_proxy.md>) for instructions on how to correctly
 configure a reverse proxy.
 
+### Known issues
+
+**HTTP `308 Permanent Redirect` redirects are not followed**: Due to missing features
+in the HTTP library used by Synapse, 308 redirects are currently not followed by
+federating servers, which can cause `M_UNKNOWN` or `401 Unauthorized` errors. This
+may affect users who are redirecting apex-to-www (e.g. `example.com` -> `www.example.com`),
+and especially users of the Kubernetes *Nginx Ingress* module, which uses 308 redirect
+codes by default. For those Kubernetes users, [this Stackoverflow post](https://stackoverflow.com/a/52617528/5096871) 
+might be helpful. For other users, switching to a `301 Moved Permanently` code may be
+an option. 308 redirect codes will be supported properly in a future
+release of Synapse.
+
 ## Running a demo federation of Synapses
 
 If you want to get up and running quickly with a trio of homeservers in a