This document is for a development version of Ceph.

Looking up Monitors through DNS

Since version 11.0.0 RADOS supports looking up Monitors through DNS.

This way daemons and clients do not require a mon host configuration directive in their ceph.conf configuration file.

Using DNS SRV TCP records clients are able to look up the monitors.

This allows for less configuration on clients and monitors. Using a DNS update clients and daemons can be made aware of changes in the monitor topology.

By default clients and daemons will look for the TCP service called ceph-mon which is configured by the mon_dns_srv_name configuration directive.


the service name used querying the DNS for the monitor hosts/addresses





see also



When the DNS search domain is set to a DNS zone file might contain the following elements.

First, create records for the Monitors, either IPv4 (A) or IPv6 (AAAA). AAAA 2001:db8::100 AAAA 2001:db8::200 AAAA 2001:db8::300 A A A

With those records now existing we can create the SRV TCP records with the name ceph-mon pointing to the three Monitors. 60 IN SRV 10 20 6789 60 IN SRV 10 30 6789 60 IN SRV 20 50 6789

Now all Monitors are running on port 6789, with priorities 10, 10, 20 and weights 20, 30, 50 respectively.

Monitor clients choose monitor by referencing the SRV records. If a cluster has multiple Monitor SRV records with the same priority value, clients and daemons will load balance the connections to Monitors in proportion to the values of the SRV weight fields.

For the above example, this will result in approximate 40% of the clients and daemons connecting to mon1, 60% of them connecting to mon2. However, if neither of them is reachable, then mon3 will be reconsidered as a fallback.