Documentation for Service Operators
Domain listing criteria
For a domain to be included in the crawl, it must not be a gateway to
another network. We do not want to list channels on other instant messaging
networks (such as Matrix) at this place. We may list gateway services in a
dedicated list in the future (if you host a gateway service and want to
be part of such a list, get in touch).
Other than that, there are no limitations, except that we need to know about the domain. If channels from your domain are not listed and you want them to be listed, follow the instructions in the documentation for owners to get a public channel from your domain listed. The next crawl will then include all channels published by your service.
If channels from your domain are still not included, ensure that your service actually does list public channels in a disco#items
request as per the relevant section in XEP-0045 (Multi User Chat). If you are sure this is the case and your channels have not been included in the listing 24 hours after your invitation, please get in touch.
Domain delisting
If you are the owner of a domain and want it to be completely excluded from the listing, please get in touch. Be prepared to provide proof that you are the owner of the domain. A good (zero-roundtrip) way to do so is to contact us from an XMPP address which is listed in your service’s contact addresses.
Domains which have not been reachable for more than seven days will be delisted automatically, including all of their channels.
Traffic
We crawl all known domains for public channels approximately once per hour. In addition, we query all channels we know for their meta-information in a similar rhythm. We rate-limit our requests and shuffle the list of channels to spread the load evenly across the time window.
If you still find that we cause too much traffic on your domain, please get in touch (see above). We can work out to reduce the frequency for your domain or apply other means.
Features
In order to provide your channel owners with optimal integration, we suggest that you update your server software to the latest release. Below is a table of features and the required server software versions (to the best of our knowledge):