You can add your server below if it meets the federation and public room requirements. Make sure your server and rooms satisfy all of the following:
Server must be reachable over federation (check here).
Server must publish its public rooms directory over federation.
Room(s) must be explicitly marked as public in settings.
Room(s) must have an alias (like #room:server.com
).
Room(s) must be federated (m.federate
enabled — default).
Room(s) must be added to the server’s public rooms directory.
For full technical details on how indexing works, please see the officialMRS documentation.
To manually trigger server discovery, you can use the following API call:
curl -X POST https://apicdn.matrixrooms.info/discover/example.com
Replace example.com
with your server’s name. Discovery happens automatically during daily reindexing.
Your server must expose the public rooms over federation using the/_matrix/federation/v1/publicRooms
endpoint.
Example URL:
https://matrix.etke.cc:8448/_matrix/federation/v1/publicRooms
Common error:
{"errcode":"M_FORBIDDEN","error":"You are not allowed to view the public rooms list of example.com"}
If you see this error, you need to configure your homeserver correctly:
For Synapse: add this to your homeserver.yaml
:
allow_public_rooms_over_federation: true
For deployment tools likeetkecc/ansible ormdad, add this to your vars.yml
:
matrix_synapse_allow_public_rooms_over_federation: true