included .well-known port announcement

makomi · Jun 24, 2019 · 9d70310 · 9d70310
1 parent dee6518
commit 9d70310
Showing 1 changed file with 20 additions and 1 deletion.
diff --git a/source/guide_synapse.rst b/source/guide_synapse.rst
@@ -244,7 +244,12 @@ for ease of use we will make use of ``uberspace web backend`` and point it to 80
 
 .. include:: includes/web-backend.rst
 
-To enable federation as described _Matrix_Federation we need to announce it by setting a DNS record in the following format:
+To enable federation as described _Matrix_Federation we need to announce it either via DNS or via .well-known.
+
+DNS announcement
+----------------
+
+The port can can be announced by setting a DNS record in the following format:
 
 .. code-block::
 
@@ -258,6 +263,20 @@ for example like this:
 
 .. note:: this can be checked by running ``dig -t srv _matrix._tcp.my.domain.name``
 
+.well-known announcement
+------------------------
+
+The federation port can also be announced via a file ``~/html/.well-known/matrix/server``
+
+.. code-block:: json
+  {
+    "m.server": "my.domain.name:47741"
+  }
+
+This has to be made available under ``/.well-known/matrix`` via the web backend:
+
+.. include:: includes/web-backend.rst
+
 Configure Certificates
 ----------------------