NAME

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

SYNOPSIS

$ matrixtool resolve my-server.org

DESCRIPTION

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.

OPTIONS

The following additional options are recognised:

--address, -a

Also resolve hostnames into IP addresses in printed output.

EXAMPLES

For example, retrieving the matrix.org server's information:

$ matrixtool resolve matrix.org
[INFO] Resolved matrix.org by SRV
target=matrix.org port=8448

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

$ matrixtool resolve -a matrix.org
[INFO] Resolved matrix.org by SRV
target=matrix.org port=8448
  83.166.64.33: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 example.org
[INFO] Using legacy IP address fallback
target=example.org port=8448

AUTHOR

Paul Evans <leonerd@leonerd.org.uk>