Skip to content
local-cert
Browse the documentation

Gandi provider

local-cert manages Gandi LiveDNS with a Personal Access Token, which you limit to the domains and permissions that are strictly necessary.

1. Create the token

  1. In Gandi: Organizations → the organization that owns the domains → Sharing → Personal Access Tokens → Create a token. Direct link: https://admin.gandi.net/organizations/account/pat.
  2. Name: local-cert. Expiration: the longest you are comfortable with — when it expires, issuance and renewals stop.
  3. Resources: restrict to the domains local-cert must manage.
  4. Permissions: check Manage domain technical configurations. The related read permissions get checked automatically.
  5. Create, then copy the token: it is displayed only once.

2. Create the provider

  1. Providers → + New provider → Gandi.
  2. Give it a name and paste the token.
  3. Test connection, then Save.

3. Add a domain

Domains → + Add a domain → this provider → the domain. The test creates and then deletes a temporary TXT record.

Good to know

  • The domain must use LiveDNS (ns-*.gandi.net servers). A domain registered at Gandi but served by external name servers doesn't appear in the list.
  • Minimum TTL: 300 seconds. local-cert raises any lower value. This has no effect on certificate issuance.
  • To switch tokens as one nears expiry: Providers → Edit, paste the new one, Test, Save.

Troubleshooting

MessageCause
401Token mistyped, expired or deleted.
403The token lacks the technical configuration permission, or the domain is not among its resources.
The zone list is emptyNone of the domains in the token's scope uses LiveDNS.