SRV Records

A Service record (SRV record) is a specification of data in the Domain Name System (DNS) defining the location (i.e. the hostname and port number) of servers for specified services. It is defined in RFC2782.

Default Ports

XMPP

For TCP connections (RFC6120)

• Server 2 Server (S2S) - 5269
• Client 2 Server (C2S) - 5222 (START TLS) / 5223 (DIRECT TLS)

Record format

An SRV record has the form:

_service._proto.name TTL class SRV priority weight port target

• service: the symbolic name of the desired service.
• proto: the transport protocol of the desired service; this is usually either TCP or UDP.
• name: the domain name for which this record is valid.
• TTL: standard DNS time to live field.
• class: standard DNS class field (this is always IN).
• priority: the priority of the target host, lower value means more preferred.
• weight: A relative weight for records with the same priority.
• port: the TCP or UDP port on which the service is to be found.
• target: the canonical hostname of the machine providing the service.

XMPP SRV records

_xmpp-client._tcp.domain.tld. TTL IN SRV priority weight port target
_xmpps-client._tcp.domain.tld. TTL IN SRV priority weight port target
_xmpp-server._tcp.domain.tld. TTL IN SRV priority weight port target
_xmpps-server._tcp.domain.tld. TTL IN SRV priority weight port target

Example 1

_xmpp-client._tcp.domain.tld. 86400 IN SRV 5 0 5222 domain.tld.
_xmpps-client._tcp.domain.tld. 86400 IN SRV 5 0 5223 domain.tld.
_xmpp-server._tcp.domain.tld. 86400 IN SRV 5 0 5269 domain.tld.

The XMPP domain is domain.tld and the server is domain.tld.

Example 2

_xmpp-client._tcp.domain.tld. 86400 IN SRV 5 0 5222 server.domain.tld.
_xmpps-client._tcp.domain.tld. 86400 IN SRV 5 0 5223 server.domain.tld.
_xmpp-server._tcp.domain.tld. 86400 IN SRV 5 0 5269 server.domain.tld.

The XMPP domain is domain.tld and the server is server.domain.tld.

Example 3

_xmpp-client._tcp.domain.tld. 86400 IN SRV 5 50 5222 server1.domain.tld.
_xmpp-client._tcp.domain.tld. 86400 IN SRV 10 30 5222 server2.domain.tld.
_xmpp-client._tcp.domain.tld. 86400 IN SRV 10 10 5222 server3.domain.tld.
_xmpp-client._tcp.domain.tld. 86400 IN SRV 10 10 5222 server4.domain.tld.
_xmpp-client._tcp.domain.tld. 86400 IN SRV 15 0 5222 backup.domain.tld.
_xmpp-server._tcp.domain.tld. 86400 IN SRV 5 50 5269 server1.domain.tld.
_xmpp-server._tcp.domain.tld. 86400 IN SRV 10 30 5269 server2.domain.tld.
_xmpp-server._tcp.domain.tld. 86400 IN SRV 10 10 5269 server3.domain.tld.
_xmpp-server._tcp.domain.tld. 86400 IN SRV 10 10 5269 server4.domain.tld.
_xmpp-server._tcp.domain.tld. 86400 IN SRV 15 0 5269 backup.domain.tld.

The XMPP domain is domain.tld and the principal server is server1.domain.tld which used 50% after server2.domain.tld 30%, server3.domain.tld 10%, server4.domain.tld 10% too, if server1 is down, server2, server3 and server4 will work, if servers 1/2/3/4 are down, backup will work.

Retrieving XMPP SRV records

$ dig SRV _xmpp-client._tcp.domain.tld
$ dig SRV _xmpp-server._tcp.domain.tld

External links

• XEP-0368: SRV records for XMPP over TLS
• RFC2782: A DNS RR for specifying the location of services (DNS SRV)
• RFC6120: Extensible Messaging and Presence Protocol (XMPP): Core