Add documentation for matrix federation + traefik labels for federation via port 8448 on matrix-federation entrypoint #62

Open
notplants wants to merge 2 commits from compress-and-federate into compress
Owner
No description provided.
notplants added 2 commits 2026-05-25 17:08:44 +00:00
Adds a second Traefik router on the web (nginx) service that listens on
the `matrix-federation` entrypoint (host port 8448 via the traefik
recipe's compose.matrix.yml) and uses Host(${SERVER_NAME}).

Lets remote homeservers reach this server's federation/key endpoints via
the standard `<server_name>:8448` fallback when no .well-known or SRV
delegation exists for SERVER_NAME — useful when SERVER_NAME differs from
DOMAIN and no external service serves /.well-known/matrix/server.

Requires MATRIX_FEDERATION_ENABLED=1 on the traefik stack.
notplants changed title from Add documentation for matrix federation + traefik labels for federation via port 8443 on matrix-federation entrypoint to Add documentation for matrix federation + traefik labels for federation via port 8448 on matrix-federation entrypoint 2026-05-25 17:10:19 +00:00
Author
Owner

This PR makes use of the entrypoint provided by traefik here: coop-cloud/traefik#105

previously compose.matrix.yml was forwarding port 9001 (not sure why, I don't think thats used by matrix).

between these two PRs, this allows federation via port 8448

also added documentation about allowing federation via the container built-in /.well-known and via an external /.well-known (e.g. on a webserver on the apex domain)

This PR makes use of the entrypoint provided by traefik here: https://git.coopcloud.tech/coop-cloud/traefik/pulls/105 previously compose.matrix.yml was forwarding port 9001 (not sure why, I don't think thats used by matrix). between these two PRs, this allows federation via port 8448 also added documentation about allowing federation via the container built-in /.well-known and via an external /.well-known (e.g. on a webserver on the apex domain)
Owner

Looks beautiful, great docs!

Looks beautiful, great docs!
This pull request can be merged automatically.
This branch is out-of-date with the base branch
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin compress-and-federate:compress-and-federate
git checkout compress-and-federate
Sign in to join this conversation.
No description provided.