Checks that federation is correctly configured on a matrix server.
Requires Go 1.18.
git clone https://github.com/matrix-org/matrix-federation-tester
cd matrix-federation-tester
go build
An HTTP daemon can be started as follows:
BIND_ADDRESS=:8080 ./matrix-federation-tester
Alternatively, the federation tester can be used from the commandline via the
-lookup
parameter:
./matrix-federation-tester -lookup <server_name>
The federation tester may be accessed using the following templated URLs. Please replace <server_name>
with your server name (eg: matrix.org
).
Full JSON report
https://matrix.org/federationtester/api/report?server_name=<server_name>
Plain text response
Returns GOOD
if the federation is ok and BAD
if it's not ok.
https://matrix.org/federationtester/api/federation-ok?server_name=<server_name>