Skip to content

Settings

Module-wide settings live at /admin/config/content/dns and require the administer dns permission.

Allow TLD zones

Default: off.

When off (the default), zone names must contain at least two labels separated by a dot — e.g. example.com, münchen.de. Single-label inputs like com or de are rejected at validation time.

When on, single-label zone names are accepted. This is occasionally useful for internal-only namespaces (e.g. an internal .lan or .test zone), test fixtures, or operators of actual TLDs.

If you flip this on, existing valid zones aren't affected — the check only runs at zone creation and update.

Default TTL

Default: 3600 (one hour).

The TTL pre-filled into the record form when a user creates a new record. The user can override per record.

This is purely a UX default; it doesn't constrain what TTLs records can have. Zero is allowed and means "no caching." Negative values are rejected by the field's unsigned-integer constraint.

Future settings

These are placeholders for features on the 2.x/3.x roadmap. They are not present in the current settings form:

  • Validate against the IANA TLD list — would refuse zone names whose final label isn't a registered TLD, with a configurable refresh cadence and graceful fallback when the IANA fetch fails.
  • Default record type — pre-select something other than A on the add-record form.
  • Provider-sync defaults — once the provider plugin manager lands, the per-provider auth and reconciliation settings will live here or under /admin/config/services/dns/providers.