Table of Contents

Ubiquiti - CLI - Static DNS entry

ssh into your Controller

ssh into your Controller (NOT the USG!).

For controller on:

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
{
    "system": {
         "static-host-mapping": {
             "host-name": {
                  "test1.localdomain": {
                         "alias": [
                                "test1"
                         ],
                         "inet": [
                           "192.168.99.99"
                       ]
                   }
              }
         }
    }
}

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:

Verify

Verify the setting by ssh'ing into your USG, enter “configure” and “show system” where the test1-entry now will show up under static-host-mapping.

References

https://help.ui.com/hc/en-us/articles/115004872967-UniFi-Where-is-unifi-base-