Skip to main content

7. Troubleshooting

logo

"Test" reports an error instead of Success. The badge shows the specific failure — Authentication failed, Forbidden, Not found, Rate limited, Upstream error, Network error, or Timeout — and the diagnostics panel keeps the provider's own message. Authentication failed and Forbidden almost always mean the credential is valid syntactically but missing a required scope (Cloudflare) or belongs to a non-super-admin account (Dinahosting) — see the driver-specific requirements in the main README.

The "New record" form doesn't appear on a domain's Records tab. Two independent causes, each shown as its own message in place of the form:

  • "Domain Manager is in read-only mode" — a Setup → General → Domain Manager toggle disables all write-back cluster-wide; an administrator needs to turn it off.
  • "You do not hold write-back rights for any record type on this domain" — your profile is missing the per-type (A/AAAA/CNAME/TXT) right for this record's type. Ask an administrator to grant it from the Domain Manager tab on your profile.

Even when neither message appears, write-back only exists for domains whose DNS provider is Cloudflare, IONOS, or Dinahosting — any domain whose provider was auto-detected from NS records (rather than configured as a driver) has no write-back at all.

A field on the domain won't accept an edit. Fields Domain Manager fills from a sync (registration date, expiry, DNS record values, etc.) are locked against manual edits by default, so a sync can't be silently overwritten by a stale local edit. A user holding the "Unlock imported domain data" right can edit them anyway; grant it per profile from Administration → Profiles → (profile) → Domain Manager.

Import lists domains I didn't expect, or is missing some. Import only lists what the provider's API actually returns for the credentials entered — if a domain is missing, check that the API token/account has access to it at the provider directly. A domain flagged "Registrar mismatch" already exists in GLPI under a different Supplier; reassign it from the same dialog rather than importing a duplicate.

Adding support for another provider

My registrar or DNS provider isn't supported, or is only detected. Domain Manager has full API drivers for Cloudflare, IONOS and Dinahosting, and recognizes many more providers from their name servers (see Supported providers). A provider that is only recognized has no credentials, discovery, sync or write-back. There are two ways to get a full driver for yours:

  • Contribute it yourself — the plugin is open source. A driver connects to the provider's API to read the registration data and DNS records of its domains, and optionally to create, change and delete records. Open an issue on the plugin's repository first to agree the scope, then send a pull request with the driver, its credentials fields and a short sheet describing the provider's limits. If the provider's name servers are missing from the recognized list, a pull request adding them to the name server registry is welcome on its own and doesn't need a driver.
  • Give us a sandbox account — a driver can only be checked against the real service, and the quickest way to a working one is a test account we can try it on. Send the maintainers a sandbox or test account on the provider (API credentials with a couple of throwaway domains, never your production account) and we'll use it to build and verify the driver. Say which features you need (read only, or also write-back) so we can plan the work.
  • Hire us to build it — if you would rather not manage the work yourself, TICGAL can develop the driver for you as a paid project. Get in touch through tic.gal/contact with the provider's name and the features you need, and we'll send a quote.

Generated for Domain Manager 1.8.0-beta.4 on GLPI 11.0 — 2026-10-20.