Skip to content

Tester for matrix federation written in golang.

Notifications You must be signed in to change notification settings

matrix-org/matrix-federation-tester

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Matrix Federation Tester

Checks that federation is correctly configured on a matrix server.

Building

Requires Go 1.18.

git clone https://github.com/matrix-org/matrix-federation-tester
cd matrix-federation-tester
go build

Running

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>

HTTP API

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>