OPNsense Forum

English Forums => 25.7, 25.10 Series => Topic started by: willj8823 on October 26, 2025, 03:22:49 AM

Title: How I got my Unbound DNS Overrides/Aliases to be Visible Again
Post by: willj8823 on October 26, 2025, 03:22:49 AM
Currently running 25.7.6
 
Word of caution: Novice at work!
 
I use Unbound DNS Overrides/Aliases to forward requests to NGINX Proxy Manager for my internal services. I started to add a new alias to one of my hosts and realized that my previously defined aliases were no longer visible in the Web GUI. Although the aliases were no longer visible, they still worked. This really puzzled me. As a test, I created a new Test alias on a previously used host, and the new alias was visible in the Web GUI.
 
I downloaded and examined the config file and confirmed that all of the no longer visible aliases were still defined in the config file. I noticed that although the host reference in the stanza for the test alias definition matched the corresponding host uuid, all of the stanzas for the aliases that were not visible in the GUI referenced a different host (uuid) for which I could not find a matching host definition.
 
Overrides Host Definition
 
        <host uuid="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx">
          <enabled>1</enabled>
          <hostname>local</hostname>
          <domain>xyz.com</domain>
          <rr>A</rr>
          <mxprio/>
          <mx/>
          <ttl/>
          <server>10.10.10.108</server>
          <txtdata/>
          <description>local via nginx</description>
        </host>
 
Test Alias
 
        <alias uuid="12e3fd92-4ead-4876-bc39-d0e74c559985">
          <enabled>1</enabled>
          <host> xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx </host>   ç Matches uuid above
          <hostname>test</hostname>
          <domain>local.xyz.com</domain>
          <description>Test Override Alias</description>
        </alias>
 
Existing Alias
 
        <alias uuid="12e3fd92-4ead-4876-bc39-d0e74c559985">
          <enabled>1</enabled>
          <host>yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy</host>  ç Does not match uuid above
          <hostname>existing</hostname>
          <domain>local.xyz.com</domain>
          <description>Existing Alias</description>
        </alias>
 
Since the host uuid in the Test Alias stanza matched the host uuid for the referenced host (Alias is visible), I decided to change the uuid values in all of the Alias stanzas to match the uuid values in the referenced host definitions. 

After I replaced all the Existing host uuid values in each Alias stanza with the uuid values from the referenced Host definitions, I restored the Unbound DNS settings from the modified config file using System/Configuration/Backups.  After the Unbound DNS settings were restored, all of my Unbound DNS Overrides/Aliases became visible in the Web GUI again.
 
By the way, I do not know how long the aliases have not been visible in the Web GUI. I found the mismatch between the uuid values in the Alias stanzas and the uuid values in the referenced hosts in my backup files going back at least to early July
 
Will