The methods are strongly disrecommended and hidden in <details> elements

@@ -0,0 +1,111 @@
+# Delegation/split-domain
+
+Matrix allows clients and servers to discover a homeserver's "true" destination via _`.well-known` delegation_. This is especially useful if you would like to:

@@ -0,0 +1,125 @@
+# Delegation/split-domain

@@ -0,0 +5,4 @@
+- Serve Continuwuity on a subdomain while having only the base domain for your usernames
+- Use a port other than `:8448` for server-to-server connections
+
+This guide will show you how to have `@user:example.com` usernames while serving Continuwuity on `https://matrix.example.com`. It assumes using port 443 for both client-to-server connections and server-to-server federation.

@@ -0,0 +11,4 @@
+
+First, ensure you have set up A/AAAA records for `matrix.example.com` and `example.com` pointing to your IP.
+
+Then, ensure that the `server_name` field matches your intended username suffix. If this is not the case, you **MUST** wipe the database directory and reinstall Continuwuity with your desired `server_name`

@@ -0,0 +46,4 @@
+
+## Serving with a reverse proxy
+
+The steps above will generate three JSON files: `.well-known/matrix/client`, `.well-known/matrix/server`, and `.well-known/matrix/support`. To enable discovery of your homeserver's destination and contact details, you will need to serve these files from your base domain.

@@ -0,0 +81,4 @@
+
+</details>
+
+Bring up Continuwuity and the reverse proxy. You should now see the following contents

@@ -0,0 +116,4 @@
+
+### Cannot log in with web clients
+
+Make sure there is an `Access-Control-Allow-Origin: *` header in your `.well-known/matrix/client` path. While continuwuity serves this header by default, it may be dropped by reverse proxies or other middlewares.

@@ -0,0 +122,4 @@
+
+## Using SRV records (not recommended)
+
+The following methods uses the legacy SRV records and only apply to federation traffic. They are provided only for completeness, and are **not recommended** for most users due to increased complexity with little benefits. If you have already set up `.well-known` delegation as above, you can safely skip this part.

@@ -0,0 +48,4 @@
+
+After doing the steps above, Continuwuity will serve these 3 JSON files:
+
+- `.well-known/matrix/client`: for Client-Server discovery