User Tools

Site Tools


ubiquiti:cli:dns_forwarding

Ubiquiti - CLI - DNS forwarding

ssh into your Controller

ssh into your Controller (NOT the USG!).

For controller on:

  • Windows: C:\Users\<user>\Ubiquiti UniFi\data\sites\default
  • Mac: /Users/<user>/Library/Application Support/UniFi/data/sites/<site-name>/config.gateway.json
  • Ubuntu: /usr/lib/unifi/data/sites/default
  • CloudKey: /srv/unifi/data/sites/default

NOTE: Use the site-name you had configured instead of “default” if you did.


Create/Edit the file config.gateway.json in your site directory:

config.gateway.json
{
	"service": {
		"dns": {
			"forwarding": {
				"options": [
					"host-record=AP-EG-WZ.WORKGROUP,192.168.1.3",
					"host-record=AP-OG-SZ.WORKGROUP,192.168.1.5"
				]
			}
		}
	}
}

NOTE: It is a good habit to run a sanity check on your .json file before pushing it to the device.

Simply copy & paste it to JSON Formatter & Validator. There are many of them available such as https://jsonformatter.curiousconcept.com/


Finalize

Once the file is on the UniFi-Controller:

  • Navigate to Devices.
  • Click your USG.
  • Click the “Config”-icon
  • Click “Manage Device” and pick “Provision” under Force Provisioning.

Verify

Verify the setting by ssh'ing into your USG, enter “configure” and “show system”.


References

ubiquiti/cli/dns_forwarding.txt · Last modified: 2020/09/15 09:14 by 192.168.1.1

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki