Table of Contents

Ubiquiti - CLI - mDNS Repeater

Enable Multicast DNS in the GUI:


To use mDNS repeater on the USG.

The mDNS option in the controller will enable mDNS reflector.


/srv/unifi/data/sites/default/config.gateway.json
{
  "service": {
    "mdns": {
      "repeater": {
        "interface": [
          "eth1",
          "eth1.100",
          "eth1.110"
        ]
      }
    }
  }
}

NOTE: Change out the 100 and 110 for whatever VLANs you want, add more if needed.

Syntax:

'mdns repeater interface xxxxx' where xxxxx is/are the interface(s) mDNS advertisements are from as well as repeat mDNS advertisements to. That means both the source and target interfaces must be added.

Test your .json code using the json validator.

Once the config.gateway.json file is created or edited:

  • In the Controller GUI, navigate to Devices → Unifi Security Gateway → Config → Force Provision → Provision.

Once the USG comes back online you should be all set.


To identify the interfaces you're interested in using with the mdns repeater, SSH into your USG and run the show interfaces command. You can look at the interface and the corresponding IP address to determine the networks to place the repeater on. The virtual interface numbers should match your VLAN IDs from network setup.

show interfaces
 
Codes: S - State, L - Link, u - Up, D - Down, A - Admin Down
Interface    IP Address                        S/L  Description
---------    ----------                        ---  -----------
eth0         192.168.0.1/24                    u/u  LAN
eth0.10      192.168.10.1/24                   u/u
eth0.20      192.168.20.1/24                   u/u
eth0.33      192.168.33.1/24                   u/u
eth0.40      192.168.40.1/24                   u/u
eth0.50      192.168.50.1/24                   u/u
eth1         -                                 A/D
eth2         1.1.1.1/32                        u/u  WAN
eth3         -                                 A/D
lo           127.0.0.1/8                       u/u
             ::1/128

NOTE: Before you can SSH into your device you will need to Enable advanced features in the controller's site settings.

SSH tutorial: https://help.ubnt.com/hc/en-us/articles/218850057-Intro-to-Networking-How-to-Establish-a-Connection-Using-SSH


Troubleshooting

Alternate between enabling / disabling some of these settings may work.

Enable IGMP Snooping as it can help with multicast traffic:

Enable Multicast Enhancement:

Enable MulticastDNS Service:

NOTE: Enabling the mDNS feature will enable a service on the USG that will reflect (mirror) mDNS packets into all other networks including WAN.

Ensure Firewall is not blocking:


References

https://help.ui.com/hc/en-us/articles/215458888-UniFi-USG-Advanced-Configuration-Using-config-gateway-json

json validator

https://help.ubnt.com/hc/en-us/articles/218850057-Intro-to-Networking-How-to-Establish-a-Connection-Using-SSH

https://help.ui.com/hc/en-us/articles/360001004034-UniFi-Best-Practices-for-Managing-Chromecast-Google-Home-on-UniFi-Network

https://en.m.wikipedia.org/wiki/IGMP_snooping