{
  "schema_version": 2,
  "id": "operate/rs/networking/mdns",
  "title": "Client prerequisites for mDNS",
  "url": "https://redis.io/docs/latest/operate/rs/networking/mdns/",
  "summary": "Requirements for using the mDNS protocol in development and testing environments.",
  "tags": [
    "docs",
    "operate",
    "rs"
  ],
  "last_updated": "2026-09-24T10:14:24+01:00",
  "page_type": "content",
  "content_hash": "64ef0a63b49ac82fcd62caf070f1fd196605493d7b28995be7b91573c9c0d47f",
  "sections": [
    {
      "id": "content",
      "title": "Content",
      "role": "content",
      "text": "> [!NOTE]\n> mDNS is only supported for development and testing environments.\n\nIf you choose to use the mDNS protocol when [you set the cluster name](https://redis.io/docs/latest/operate/rs/networking/cluster-dns),\nmake sure that the configurations and prerequisites for resolving database endpoints are met on the client machines.\nIf you have [Replica Of](https://redis.io/docs/latest/operate/rs/databases/import-export/replica-of) databases on the cluster,\nthe configurations and prerequisites are also required for the Redis Software nodes.\n\nTo prepare a client or node for mDNS:\n\n1. Make sure that the clients and cluster nodes are on the same physical network\n    or have the network infrastructure configured to allow multicasting between them.\n1. Install these prerequisite packages:\n\n    - For Ubuntu:\n\n        [code example]\n\n    - For RHEL/CentOS 6.x:\n\n        [code example]\n\n    - For RHEL/CentOS 7:\n\n        [code example]\n\n1. If you are using [mDNS with IPv6 addresses](https://redis.io/docs/latest/operate/rs/networking/multi-ip-ipv6),\n    update the hosts line in `/etc/nsswitch.conf` to:\n\n    [code example]"
    }
  ],
  "examples": [
    {
      "id": "content-ex0",
      "language": "sh",
      "code": "apt-get install libnss-mdns",
      "section_id": "content"
    },
    {
      "id": "content-ex1",
      "language": "sh",
      "code": "$ rpm -ivh http://download.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm\n        $ yum install nss-mdns\n        $ service avahi-daemon start",
      "section_id": "content"
    },
    {
      "id": "content-ex2",
      "language": "sh",
      "code": "$ rpm -ivh https://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/e/epel-release-7-12.noarch.rpm\n        $ yum install nss-mdns\n        $ service avahi-daemon start",
      "section_id": "content"
    },
    {
      "id": "content-ex3",
      "language": "yaml",
      "code": "hosts: files mdns4_minimal\n    \\[NOTFOUND=return\\] mdns",
      "section_id": "content"
    }
  ]
}
