Troubleshooting DNS runtime

Recover when DNS records change in Nanami but lookups stay stale or the DNS runtime reports an error.

Community operators troubleshooting DNS runtime freshness and gateway-side DNS rendering.

You can confirm whether DNS runtime is enabled, rendered, and actually serving the expected records.

Access to the gateway host · Access to the affected network runtime view

Use this guide when DNS changes show up in the product but client lookups do not update.

Check that DNS runtime is actually enabled

Confirm that:

The network runtime status should show DNS as running and should not report a recent last error.

Useful commands on the gateway host:

bash

Nanami docs

ls -la /var/lib/nanami/gateway/dns
cat /var/lib/nanami/gateway/dns/Corefile
ps aux | grep coredns
dig @100.64.0.10 api.<zone> A

If runtime files are missing, repair the runtime first.
If the process is not running, fix the gateway runtime instead of editing more DNS records.
If records still do not match after runtime recovery, revisit the published domain model in Domain and URL strategy.

Pick the most useful next step instead of the next random article.