The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.


matrixtool resolve - Look up hostnames or IP addresses of a server


   $ matrixtool resolve


This command attempts to find the hostnames or IP addresses to use to communicate with a given Matrix homeserver. It does not attempt to actually talk to the server, it merely queries in DNS for information on how to find the server. It is typically the first diagnostic command to use to determine whether Matrix server federation is working, and if not where it is failing.


The following additional options are recognised:

--address, -a

Also resolve hostnames into IP addresses in printed output.


For example, retrieving the server's information:

   $ matrixtool resolve
   [INFO] Resolved by SRV port=8448

We can also see the IP addresses associated with these hostnames:

   $ matrixtool resolve -a
   [INFO] Resolved by SRV port=8448

Some networks don't publish a SRV record in DNS, so for those the hostname is implied directly from the server name. For example:

   $ matrixtool resolve
   [INFO] Using legacy IP address fallback port=8448


Paul Evans <>